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".
Clique em "Próxima" e selecione a guia "Bibliotecas". Adicione todos os arquivos JAR dependentes que você salvou clicando em "Add JARs externos".
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.
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.
Por fim, clique em "Finish" e crie seu novo projeto.
Para criar um aplicativo de teste simples, crie uma nova classe com um método principal selecionando "New > Class" no menu "File".
Agora vou colar um código do Guia do desenvolvedor da API Documents List.
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.
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.
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".
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.