aprile 2008
- Introduzione
- Configurare Eclipse
- Installazione delle librerie necessarie
- Creazione di una nuova applicazione
- Conclusione
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](https://google-developers.gonglchuangl.net/static/gdata/articles/support/eclipse_gdata/eclipse_gdata1.png?authuser=0&hl=it)
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](https://google-developers.gonglchuangl.net/static/gdata/articles/support/eclipse_gdata/eclipse_gdata2.png?authuser=0&hl=it)
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](https://google-developers.gonglchuangl.net/static/gdata/articles/support/eclipse_gdata/eclipse_gdata3.png?authuser=0&hl=it)
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](https://google-developers.gonglchuangl.net/static/gdata/articles/support/eclipse_gdata/eclipse_gdata4.png?authuser=0&hl=it)
Infine, puoi fare clic su "Fine" e creare il nuovo progetto.
![Il progetto appena creato](https://google-developers.gonglchuangl.net/static/gdata/articles/support/eclipse_gdata/eclipse_gdata5.png?authuser=0&hl=it)
Per creare una semplice applicazione di test, crea una nuova classe con un metodo principale selezionando "Nuovo > Classe" dal menu File.
![Creare un corso](https://google-developers.gonglchuangl.net/static/gdata/articles/support/eclipse_gdata/eclipse_gdata6.png?authuser=0&hl=it)
Ora incollerò del codice dalla Guida per gli sviluppatori per l'API Elenco documenti.
![Codice di esempio con errori](https://google-developers.gonglchuangl.net/static/gdata/articles/support/eclipse_gdata/eclipse_gdata7.png?authuser=0&hl=it)
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](https://google-developers.gonglchuangl.net/static/gdata/articles/support/eclipse_gdata/eclipse_gdata8.png?authuser=0&hl=it)
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](https://google-developers.gonglchuangl.net/static/gdata/articles/support/eclipse_gdata/eclipse_gdata9.png?authuser=0&hl=it)
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](https://google-developers.gonglchuangl.net/static/gdata/articles/support/eclipse_gdata/eclipse_gdata10.png?authuser=0&hl=it)
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:
- Plug-in Eclipse del client Java dell'API di dati di Google
- Documentazione relativa al protocollo Google Data su code.google.com
- Progetto della libreria client Java di Google Data
- Guida introduttiva alla libreria client Java
- Documentazione di JavaDoc
Java è un marchio di Sun Microsystems, Inc. negli Stati Uniti e in altri paesi.