Nesta página, descrevemos como usar ou modificar a biblioteca Java da visualização do Google e como contribuir com o código-fonte aberto para o projeto.
Índice
Requisitos
Você precisa ter os seguintes componentes para usar a biblioteca Java da visualização do Google:
- Um contêiner de servlet e a API Servlet versão 2.4 ou posterior. Um dos contêineres de servlet mais usados é o Apache Tomcat, que inclui a API Servlet. Consulte http://tomcat.apache.org/download-55.cgi para fazer o download do binário para a versão 5.5. Você precisa instalar apenas o módulo Core. Você também precisa do Tomcat para concluir as seções do tutorial: Primeiros passos, Como usar um armazenamento de dados externo e Como definir recursos e o fluxo de eventos.
- Java Development Kit versão 6.0
ou mais recente.
Observação: também é possível usar o JDK versão 5.0. No entanto, é necessário remover
@Override
de cada método na biblioteca que substitui um método de interface. Isso se deve à mudança no comportamento da anotação@Override
no JDK versão 6.0.
Dependências
A biblioteca Java de fonte de dados tem as seguintes dependências. A biblioteca foi testada com as versões listadas. Outras versões podem ser aceitáveis, mas não foram testadas.
Incluída na fonte ou no download:
- icu4j versão 4.0.1.
- Jakarta Commons lang versão 2.4.
- Jakarta Commons Logging versão 1.1.1.
- Biblioteca de coleções do Google versão 1.0.
- javacc versão 4.2. Isso é necessário somente se você pretende compilar as bibliotecas, por exemplo, ao modificá-las conforme descrito abaixo.
- opencsv versão 1.8. Isso é necessário apenas se você pretende usar uma fonte de dados CSV.
Não incluídos na fonte ou no download:
- Para usar a classe
SqlDataSourceHelper
com um banco de dados mySQL, você também precisa demysql.jar
no ambiente de execução. Consulte http://www.mysql.com/products/connector/j/ para ver detalhes e versões disponíveis para download.
Como usar a biblioteca como fornecida
Nesta seção, descrevemos como usar a biblioteca Java de visualização se você não precisar modificá-la. Esse processo varia de acordo com seu sistema de compilação:
Se estiver usando o Maven,configure uma dependência na biblioteca de visualização com as seguintes configurações:
- ID do grupo: com.google.visualization
- ID do artefato: visualize-datasource
- Número da versão: use a versão mais recente listada na página do projeto.
Se você estiver usando outro sistema de compilação:
- Faça o download do arquivo ZIP da biblioteca na página do projeto, descompacte os arquivos e inclua-os no projeto conforme exigido pelo sistema de compilação.
Como executar os exemplos
Os arquivos de exemplo JAR são incluídos com os JARs da biblioteca no arquivo ZIP para download. As instruções sobre como executar os exemplos estão disponíveis na página Primeiros passos.
Modificar a biblioteca
Se quiser modificar o código da biblioteca, faça o download da origem no site de hospedagem de código aberto e crie-a. Antes de fazer isso, leia as informações de licenciamento vinculadas à seção "Licença de código" na página do projeto para ver se seu caso de uso é permitido.
Siga estas etapas para fazer o download e criar a biblioteca:
- Faça o download do código-fonte usando SVN, conforme descrito na guia Origem > Finalização da compra na página de projeto de código aberto.
- Crie seu código. Se estiver criando no Maven, use o arquivo pom.xml fornecido com a origem. Se estiver criando com o Apache Ant, siga as instruções fornecidas a seguir (o código foi testado com o Ant versão 1.7.0; se você tiver uma versão anterior do Ant, talvez precise fazer upgrade)
Instruções de criação de formigas
1. Modifique as propriedades do build:
- Navegue até o subdiretório
build-src
do diretório de instalação escolhido. - Usando um editor de texto, abra o arquivo
build.properties
e faça as seguintes alterações:- Edite a propriedade
servlet-api.jar
para apontar para o arquivoservlet-api.jar
. Por exemplo, se você instalou o Tomcat no seu drivec:
no diretóriotomcat_home
, especifique a propriedadeservlet-api.jar
da seguinte maneira:
servlet-api.jar=C:/tomcat_home/common/lib/servlet-api.jar
Observação: use barras em vez de barras invertidas no caminho do arquivo, mesmo ao usar Windows.
- Para usar suas próprias cópias das dependências descritas acima, edite os caminhos no mesmo arquivo build.properties.
- Edite a propriedade
2. Crie a biblioteca:
Navegue pelo subdiretório build-src
no arquivo e digite um dos
itens a seguir:
ant datasource
: cria a biblioteca de fontes de dadosant example
: cria os exemplos.ant
: cria a fonte de dados e exemplos.ant test
: cria e executa os testes da biblioteca de fontes de dados. Isso é muito útil quando você está modificando a biblioteca.
Como contribuir para o projeto de código aberto
Se você quiser contribuir com mudanças no projeto de código aberto, será preciso ter permissões de envio no projeto. Envie um e-mail para google-visualization-api@googlegroups.com pedindo permissão e instruções sobre como enviar as alterações.