Esta página foi traduzida pela API Cloud Translation.

Como instalar a biblioteca Java da fonte de dados

Esta página descreve como usar ou modificar a biblioteca Java de visualização do Google e como contribuir para o código-fonte aberto para o projeto.

Conteúdo

Requisitos
Dependências
Usar a biblioteca conforme fornecida
Executar os exemplos
Modificar a biblioteca
Como contribuir para o projeto de código aberto

Requisitos

É necessário ter os seguintes componentes para usar a biblioteca Java de visualização do Google:

Um contêiner de servlet e a versão 2.4 ou superior da API servlet. 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 da 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.
A versão 6.0 ou posterior do Kit de desenvolvimento em Java.
Observação: também é possível usar o JDK versão 5.0. No entanto, você precisa remover @Override de todos os métodos na biblioteca que substituem um método de interface. Isso ocorre devido à mudança no comportamento da anotação @Override no JDK versão 6.0.

Dependências

A biblioteca Java da 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ídos na origem ou no download:

icu4j versão 4.0.1.
Jakarta commons lang versão 2.4.
Versão 1.1.1 do Jakarta commons Logging.
Biblioteca de coleções do Google versão 1.0.
javacc versão 4.2. Isso é necessário apenas 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 origem ou no download:

Para usar a classe SqlDataSourceHelper com um banco de dados mySQL, você também precisa de mysql.jar no ambiente de execução. Acesse http://www.mysql.com/products/connector/j/ para ver detalhes e versões para download.

Usar a biblioteca conforme 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 o sistema de build:

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: visualização-datasource
Número da versão: use o número da versão mais recente listado na página do projeto.

Se estiver usando qualquer outro sistema de build:

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 estão incluídos junto com os JARs da biblioteca no arquivo ZIP para download. As instruções sobre como executar os exemplos são fornecidas na página Primeiros passos.

Modificar a biblioteca

Se quiser modificar o código da biblioteca, faça o download do código-fonte do site de hospedagem de código aberto e crie-o. Antes de fazer isso, leia as informações de licenciamento vinculadas pela 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 Fonte > Checkout na página do projeto de código aberto.
Crie o 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 a versão 1.7.0 do Ant. Se você tem uma versão anterior do Ant, talvez seja necessário fazer upgrade.

Instruções de criação do Ant

1. Modifique suas 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 seu arquivo servlet-api.jar. Por exemplo, se você instalou o Tomcat na sua unidade c: no diretório tomcat_home, especifique a propriedade servlet-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 o Windows
- Para usar suas cópias das dependências descritas acima, edite os caminhos no mesmo arquivo build.properties.

2. Crie a biblioteca:

Navegue pelo subdiretório build-src no arquivo e digite um dos seguintes:

ant datasource: cria a biblioteca da fonte de dados.
ant example: cria os exemplos
ant: cria exemplos e fontes de dados.
ant test: cria e executa os testes da biblioteca de fontes de dados. Isso é muito útil para modificar a biblioteca.

Como contribuir com o projeto de código aberto

Se você quiser contribuir com alterações no projeto de código aberto, precisará ter permissões de envio para o projeto. Envie um e-mail para google-visualization-api@googlegroups.com solicitando permissão e instruções sobre como enviar alterações.