abril de 2008
- Introdução
- Como configurar o Eclipse
- Como instalar as bibliotecas necessárias
- Como criar um novo aplicativo
- Conclusão
Novo Plug-in de cliente Java das APIs de dados do Google : crie projetos em segundos
Como complemento a este artigo, um plug-in do Eclipse está disponível para minimizar a sobrecarga envolvida na configuração das dependências de dados do Google. Ele também cria um código boilerplate para interagir com a API que você quer usar. Assim, fica mais fácil começar a desenvolver com as APIs de dados do Google.
- Vídeo de instruções
- Fazer download
- Como instalar o plug-in
- Como iniciar um novo projeto de API Google Data
Introdução
O Eclipse é muito útil e sem custo financeiro O ambiente de desenvolvimento integrado tem um lugar especial entre os programadores de Java. Não é surpresa, então, que você queira usá-la com a biblioteca cliente Java para criar um aplicativo Java que funcione com uma das APIs de dados do Google.
Como configurar o Eclipse
Se você ainda não instalou o Eclipse, está perdendo. O Eclipse pode facilitar muito o desenvolvimento em Java, devido à capacidade de sugerir correções, encontrar importações ausentes e usar métodos de preenchimento automático. Acesse a página de downloads do Eclipse.org para instalar o instalador do seu sistema operacional. Para executar o Eclipse, você precisará ter um JRE instalado, que está vinculado à página de downloads do Eclipse. Depois de instalar o Eclipse, será preciso criar um espaço de trabalho. Esses exemplos usam /usr/local/eclipse/workspace
.
Como instalar as bibliotecas necessárias
O Eclipse oferece muitas funcionalidades prontas para uso do Java, portanto, isso deve ser fácil. Primeiro, use a versão mais recente da biblioteca de cliente Java na página de downloads do projeto. Há dois downloads separados: um para amostras e outro para o código-fonte. Faça o download do zip de exemplos, que inclui os arquivos JAR compilados da biblioteca de cliente Java necessários para criar seus próprios programas. Se você quiser saber como a biblioteca cliente funciona, faça o download do zip e procure por ele, mas isso está fora do escopo deste artigo. Depois de fazer o download das amostras do zip, descompacte o arquivo em um diretório conveniente onde você possa encontrar os arquivos. Os exemplos usam /usr/local/eclipse
. Isso significa que os arquivos JAR do projeto agora podem ser acessados em /usr/local/eclipse/gdata/java/lib
.
Agora que você instalou a biblioteca de cliente, o próximo passo é fazer o download de algumas dependências externas para que possamos incluí-las no caminho de compilação do projeto. O arquivo INSTALL-samples.txt
contém uma lista de jars necessários e locais para download. Veja a lista atual:
Nome do arquivo | Local |
---|---|
E-mail.jar | API Sun da JavaMail |
ativação.jar | Framework de ativação JavaBeans da Sun (link em inglês) |
servlet-api.jar | Apache Tomcat (em inglês) |
Neste exemplo, esses arquivos JAR são transferidos por download e copiados para /usr/local/eclipse/gdata/third_party
.
Ufa! Agora você deve ter todas as informações necessárias para começar a desenvolver um aplicativo Java que use uma das APIs de dados do Google. Continue lendo.
Como criar um novo aplicativo
A primeira etapa é abrir o Eclipse e selecionar "New > Java Project" no menu "File".
![Nova janela do projeto do Eclipse](https://developers.google.cn/static/gdata/articles/support/eclipse_gdata/eclipse_gdata1.png?authuser=8&hl=pt-br)
Clique em "Próxima" e selecione a guia "Bibliotecas". Adicione todos os arquivos JAR dependentes que você salvou clicando em "Add JARs externos".
![Como adicionar JARs de dependência](https://developers.google.cn/static/gdata/articles/support/eclipse_gdata/eclipse_gdata2.png?authuser=8&hl=pt-br)
Você também terá que adicionar os arquivos JAR da biblioteca cliente Java. Eles estão localizados no subdiretório java/lib
em que você extraiu a biblioteca de cliente. Você sempre precisará incluir os seguintes arquivos JAR: gdata-client, gdata-client-meta, gdata-core e gdata-media.
![Como adicionar JARs do GData](https://developers.google.cn/static/gdata/articles/support/eclipse_gdata/eclipse_gdata3.png?authuser=8&hl=pt-br)
Agora, escolha qual API você quer usar. Este exemplo usa a API Google Documents List. Isso requer a adição dos arquivos JAR apropriados: gdata-docs e gdata-docs-meta.
![Como adicionar JARs do DocList](https://developers.google.cn/static/gdata/articles/support/eclipse_gdata/eclipse_gdata4.png?authuser=8&hl=pt-br)
Por fim, clique em "Finish" e crie seu novo projeto.
![O projeto recém-criado](https://developers.google.cn/static/gdata/articles/support/eclipse_gdata/eclipse_gdata5.png?authuser=8&hl=pt-br)
Para criar um aplicativo de teste simples, crie uma nova classe com um método principal selecionando "New > Class" no menu "File".
![Criar uma turma](https://developers.google.cn/static/gdata/articles/support/eclipse_gdata/eclipse_gdata6.png?authuser=8&hl=pt-br)
Agora vou colar um código do Guia do desenvolvedor da API Documents List.
![Exemplo de código com erros](https://developers.google.cn/static/gdata/articles/support/eclipse_gdata/eclipse_gdata7.png?authuser=8&hl=pt-br)
Você vai ver muitos erros até adicionar as instruções de importação apropriadas. O Eclipse facilita esse processo. Basta clicar nos marcadores de erro à esquerda para acessar um menu útil que permite adicionar importações.
![Menu de correção rápida](https://developers.google.cn/static/gdata/articles/support/eclipse_gdata/eclipse_gdata8.png?authuser=8&hl=pt-br)
Depois de limpar as importações, você também vai precisar lidar com exceções que podem ser geradas pelo nosso código. O exemplo opta por cercar todo o código de amostra com um manipulador de exceções muito rudimentar.
![Exemplo de código em funcionamento](https://developers.google.cn/static/gdata/articles/support/eclipse_gdata/eclipse_gdata9.png?authuser=8&hl=pt-br)
Agora, se você substituir o nome de usuário e a senha por uma conta de teste válida criada, poderá ver uma lista de documentos dessa conta ao escolher "Executar" no menu "Executar".
![Saída do programa](https://developers.google.cn/static/gdata/articles/support/eclipse_gdata/eclipse_gdata10.png?authuser=8&hl=pt-br)
Oba!
Conclusão
Agora que você tem uma instância em funcionamento do Eclipse e todos os arquivos JAR necessários existentes, está no caminho certo para criar um aplicativo Java incrível que funcione com uma das APIs de dados do Google.
O que fazer depois disso? Alguns links podem ser úteis:
- Plug-in do cliente cliente Java das APIs de dados do Google
- Documentação do protocolo de dados do Google em code.google.com
- Projeto de biblioteca de cliente Java dos dados do Google
- Guia de primeiros passos da biblioteca de cliente Java
- Documentação do JavaDoc
Java é uma marca registrada da Sun Microsystems, Inc. nos Estados Unidos e em outros países.