Coding in the Shade: Utilizzare Eclipse con le API di dati di Google

Jeff Fisher, team delle API di dati di Google
aprile 2008

Novità Plug-in Eclipse del client Java dell'API di dati Google : crea progetti in pochi secondi

A integrazione di questo articolo, è disponibile un plug-in Eclipse per ridurre al minimo i costi di gestione legati alla configurazione delle dipendenze dei dati di Google. Crea inoltre un codice boilerplate per interagire con l'API che ti interessa. Si tratta di un modo semplice per iniziare a sviluppare con le API di dati di Google.


Introduzione

Eclipse è una funzionalità molto utile (e senza costi) L'IDE che ha un posto speciale nel cuore di molti programmatori Java. Non sorprende dunque che tu voglia utilizzarlo con la libreria client Java per creare un'applicazione Java eccezionale che funzioni con una delle API di dati di Google.

Configurazione di Eclipse

Se non hai ancora installato Eclipse, ti stai perdendo tutto. Eclipse può semplificare notevolmente lo sviluppo di Java grazie alla sua capacità di suggerire correzioni, trovare importazioni mancanti e metodi di completamento automatico. Vai alla pagina dei download di Eclipse.org per scaricare il programma di installazione per il tuo sistema operativo. Per eseguire Eclipse devi aver installato un JRE, a cui rimanda la pagina dei download di Eclipse. Dopo aver installato Eclipse, dovrai creare un'area di lavoro. Questi esempi utilizzano /usr/local/eclipse/workspace.

Installazione delle librerie necessarie

Eclipse offre tante funzionalità Java pronte all'uso, quindi dovrebbe essere facile. Per prima cosa, recupera la versione più recente della libreria client Java dalla pagina dei download del progetto. Tieni presente che esistono due download separati: uno per gli esempi e uno per il codice sorgente. Scarica il file ZIP di esempio, poiché include i file JAR compilati della libreria client Java necessari per creare i tuoi programmi. Se ti interessa scoprire come funziona la libreria client, puoi scaricare il file ZIP di origine e dare un'occhiata, ma questo non rientra nell'ambito di questo articolo. Dopo aver scaricato gli esempi di file ZIP, decomprimi il file in una comoda directory in cui puoi trovare i file. Negli esempi viene utilizzato /usr/local/eclipse. Ciò significa che ora i file JAR per il progetto dovrebbero essere accessibili in /usr/local/eclipse/gdata/java/lib.

Dopo aver installato la libreria client, la fase successiva consiste nel download di alcune dipendenze esterne in modo da poterle includere nel percorso di creazione del progetto. Il file INSTALL-samples.txt contiene un elenco di jar di cui hai bisogno e posizioni da cui scaricarli. L'elenco attuale è:

Nome file Località
mail.jar API JavaMail di Sun
attivazione.jar Framework di attivazione JavaBeans di Sun
servlet-api.jar Apache Tomcat

In questo esempio, i file JAR vengono scaricati e copiati in /usr/local/eclipse/gdata/third_party.

Fiu! Ora dovresti avere tutti gli elementi necessari per iniziare a sviluppare un'applicazione Java che utilizzi una delle API di dati di Google. Continua a leggere.

Creazione di una nuova applicazione

Il primo passaggio consiste nell'aprire Eclipse e selezionare "New > Java Project" (Nuovo > Progetto Java) nel menu File.

Eclipse nuova finestra del progetto

Ora fai clic su Avanti e seleziona la scheda Librerie. Aggiungi tutti i file JAR dipendenti che hai scaricato facendo clic su Aggiungi JAR esterni.

Aggiunta di JAR dipendenza

Dovrai inoltre aggiungere i file JAR dalla libreria client Java. Si trovano nella sottodirectory java/lib in cui hai estratto la libreria client. Dovrai sempre includere i seguenti file JAR: gdata-client, gdata-client-meta, gdata-core e gdata-media.

Aggiungere JAR JData

Ora scegli l'API che vuoi utilizzare. In questo esempio viene utilizzata l'API Elenco documenti di Google. A tal fine, devi aggiungere i file JAR appropriati: gdata-docs e gdata-docs-meta.

Aggiungere JAR DocList

Infine, puoi fare clic su "Fine" e creare il nuovo progetto.

Il progetto appena creato

Per creare una semplice applicazione di test, crea una nuova classe con un metodo principale selezionando "Nuovo > Classe" dal menu File.

Creare un corso

Ora incollerò del codice dalla Guida per gli sviluppatori per l'API Elenco documenti.

Codice di esempio con errori

Vedrai molti errori finché non aggiungi le istruzioni di importazione appropriate. Eclipse semplifica tutto questo. Tutto quello che devi fare è fare clic sugli indicatori di errore a sinistra per visualizzare un menu utile che ti consente di aggiungere le importazioni.

Il menu di correzione rapida

Una volta ripulite le importazioni, dovrai anche gestire le eccezioni che possono essere generate dal nostro codice. L'esempio sceglie di racchiudere l'intero codice di esempio con un gestore di eccezioni molto rudimentale.

Codice di esempio in esecuzione

Supponiamo ora che tu sostituisca il nome utente e la password con un account di prova valido che hai creato, dovresti riuscire a visualizzare un elenco di documenti di proprietà di tale account quando scegli "Esegui" dal menu Esegui.

L'output del programma

Ottimo.

Conclusione

Ora che hai creato un'istanza di Eclipse e tutti i file JAR necessari, sei a buon punto nel processo di creazione di un'applicazione Java fantastica che funzioni con una delle API di dati di Google.

Come procedere? Ecco alcuni link che potresti trovare utili:

Java è un marchio di Sun Microsystems, Inc. negli Stati Uniti e in altri paesi.