Como instalar a biblioteca Java da fonte de dados

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

1. Requisitos
2. Dependências
3. Como usar a biblioteca como fornecida
4. Como executar os exemplos
5. Modificar a biblioteca
6. Como contribuir para o projeto de código aberto

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 de mysql.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:

1. 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.
2. 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:

1. Navegue até o subdiretório build-src do diretório de instalação escolhido.
2. 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 arquivo servlet-api.jar. Por exemplo, se você instalou o Tomcat no seu drive 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 Windows.

   • Para usar suas próprias 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 itens a seguir:

• ant datasource: cria a biblioteca de fontes de dados
• ant 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 [e-mail] pedindo permissão e instruções sobre como enviar as alterações.