April 2008
- Einführung
- Eclipse einrichten
- Erforderliche Bibliotheken installieren
- Neue Anwendung erstellen
- Schlusswort
Neu Java-Client-Eclipse-Plug-in für Google Data APIs : Projekte in Sekundenschnelle erstellen
Als Ergänzung zu diesem Artikel steht ein Eclipse-Plug-in zur Verfügung, mit dem der mit der Einrichtung der Google-Datenabhängigkeiten verbundene Aufwand minimiert werden kann. Außerdem wird Boilerplate-Code für die Interaktion mit der gewünschten API erstellt. Dies erleichtert den Einstieg in die Entwicklung der Google Data APIs.
Einführung
Eclipse ist sehr praktisch (und kostenlos!) IDE, die in den Herzen vieler Java-Programmierer eine besondere Rolle spielt. Es ist also keine Überraschung, dass Sie sie mit der Java-Clientbibliothek verwenden sollten, um eine exzellente Java-Anwendung zu erstellen, die mit einer der Google Data APIs funktioniert.
Eclipse einrichten
Wenn Sie Eclipse noch nicht installiert haben, verpassen Sie etwas. Eclipse kann die Java-Entwicklung erheblich vereinfachen, weil sie Korrekturen vorschlagen, fehlende Importe finden und Methoden zur automatischen Vervollständigung nutzen können. Rufen Sie die Downloadseite von Eclipse.org auf, um das Installationsprogramm für Ihr Betriebssystem herunterzuladen. Für die Ausführung von Eclipse muss eine JRE installiert sein, auf die von der Eclipse-Downloadseite aus verlinkt wird. Nachdem Sie Eclipse installiert haben, müssen Sie einen Arbeitsbereich erstellen. In diesen Beispielen wird /usr/local/eclipse/workspace
verwendet.
Erforderliche Bibliotheken installieren
Eclipse bietet eine große Menge an Java-Funktionen direkt an. Das sollte also kein Problem sein. Laden Sie zuerst die neueste Version der Java-Clientbibliothek von der Downloadseite des Projekts herunter. Es gibt zwei separate Downloads: einen für Stichproben und einen für den Quellcode. Laden Sie die Beispiel-ZIP-Datei herunter, da diese die kompilierten JAR-Dateien der Java-Clientbibliothek enthält, die zum Erstellen Ihrer eigenen Programme erforderlich ist. Wenn Sie mehr über die Funktionsweise der Clientbibliothek erfahren möchten, können Sie die Quell-ZIP-Datei herunterladen und durchsehen. Dies wird in diesem Artikel jedoch nicht behandelt. Nachdem Sie die ZIP-Datei mit den Beispielen heruntergeladen haben, entpacken Sie die Datei in ein geeignetes Verzeichnis, in dem Sie die Dateien finden. In den Beispielen wird /usr/local/eclipse
verwendet. Die JAR-Dateien für das Projekt sollten jetzt unter /usr/local/eclipse/gdata/java/lib
zugänglich sein.
Nachdem Sie die Clientbibliothek installiert haben, müssen Sie als Nächstes einige externe Abhängigkeiten herunterladen, damit sie in den Projekterstellungspfad aufgenommen werden. Die Datei INSTALL-samples.txt
enthält eine Liste der erforderlichen JAR-Dateien sowie die Speicherorte für den Download. Aktuelle Liste:
Dateiname | Standort |
---|---|
mail.jar | JavaMail API von Sun |
activation.jar | Sun's JavaBeans Activation Framework |
Servlet-api.jar | Apache Tomcat |
In diesem Beispiel werden diese JAR-Dateien heruntergeladen und nach /usr/local/eclipse/gdata/third_party
kopiert.
Puh! Jetzt sollten Sie über alle Komponenten verfügen, die Sie für die Entwicklung einer Java-Anwendung benötigen, die eine der Google Data APIs verwendet. Weiterlesen!
Neue Anwendung erstellen
Öffnen Sie zuerst Eclipse und wählen Sie im Menü "File" (Datei) die Option "New > Java Project" (Neu > Java-Projekt) aus.
![Neues Eclipse-Projektfenster](https://developers-dot-devsite-v2-prod.appspot.com/static/gdata/articles/support/eclipse_gdata/eclipse_gdata1.png?authuser=8&hl=de)
Klicken Sie jetzt auf „Weiter“ und wählen Sie den Tab „Bibliotheken“ aus. Fügen Sie alle abhängigen JAR-Dateien hinzu, die Sie heruntergeladen haben, indem Sie auf „Externe JARs hinzufügen“ klicken.
![Abhängigkeits-JARs hinzufügen](https://developers-dot-devsite-v2-prod.appspot.com/static/gdata/articles/support/eclipse_gdata/eclipse_gdata2.png?authuser=8&hl=de)
Außerdem müssen Sie die JAR-Dateien aus der Java-Clientbibliothek hinzufügen. Sie befinden sich im Unterverzeichnis java/lib
, in dem Sie die Clientbibliothek extrahiert haben. Sie müssen immer die folgenden JAR-Dateien einfügen: gdata-client, gdata-client-meta, gdata-core und gdata-media.
![GData-JARs hinzufügen](https://developers-dot-devsite-v2-prod.appspot.com/static/gdata/articles/support/eclipse_gdata/eclipse_gdata3.png?authuser=8&hl=de)
Wählen Sie jetzt die gewünschte API aus. In diesem Beispiel wird die Google Documents List API verwendet. Dazu müssen die entsprechenden JAR-Dateien hinzugefügt werden: gdata-docs und gdata-docs-meta.
![JARs für Dokumentlisten hinzufügen](https://developers-dot-devsite-v2-prod.appspot.com/static/gdata/articles/support/eclipse_gdata/eclipse_gdata4.png?authuser=8&hl=de)
Klicken Sie abschließend auf „Fertigstellen“ und erstellen Sie ein neues Projekt.
![Das neu erstellte Projekt](https://developers-dot-devsite-v2-prod.appspot.com/static/gdata/articles/support/eclipse_gdata/eclipse_gdata5.png?authuser=8&hl=de)
Wenn Sie eine einfache Testanwendung erstellen möchten, erstellen Sie eine neue Klasse mit einer Hauptmethode. Wählen Sie dazu im Menü „Datei“ die Option „Neu > Klasse“ aus.
![Klasse erstellen](https://developers-dot-devsite-v2-prod.appspot.com/static/gdata/articles/support/eclipse_gdata/eclipse_gdata6.png?authuser=8&hl=de)
Nun füge ich Code aus dem Entwicklerleitfaden für die Documents List API ein.
![Beispielcode mit Fehlern](https://developers-dot-devsite-v2-prod.appspot.com/static/gdata/articles/support/eclipse_gdata/eclipse_gdata7.png?authuser=8&hl=de)
Bis Sie die entsprechenden Importanweisungen hinzufügen, werden viele Fehler angezeigt. Mit Eclipse ist dies ganz einfach. Sie müssen nur auf die Fehlermarkierungen auf der linken Seite klicken, um ein hilfreiches Menü zum Hinzufügen von Importen aufzurufen.
![Quickfix-Menü](https://developers-dot-devsite-v2-prod.appspot.com/static/gdata/articles/support/eclipse_gdata/eclipse_gdata8.png?authuser=8&hl=de)
Sobald Sie die Importe bereinigt haben, müssen Sie auch Ausnahmen handhaben, die von unserem Code ausgelöst werden können. In diesem Beispiel wird der gesamte Beispielcode mit einem sehr rudimentären Ausnahme-Handler umschlossen.
![Beispielcode funktioniert](https://developers-dot-devsite-v2-prod.appspot.com/static/gdata/articles/support/eclipse_gdata/eclipse_gdata9.png?authuser=8&hl=de)
Unter der Annahme, dass Sie den Nutzernamen und das Passwort durch ein gültiges Testkonto ersetzt haben, sollten Sie eine Liste der Dokumente dieses Testkontos sehen, wenn Sie im Menü „Ausführen“ die Option „Ausführen“ auswählen.
![Programmausgabe](https://developers-dot-devsite-v2-prod.appspot.com/static/gdata/articles/support/eclipse_gdata/eclipse_gdata10.png?authuser=8&hl=de)
Juhu!
Fazit
Nachdem Sie nun eine funktionierende Eclipse-Instanz und alle erforderlichen JAR-Dateien eingerichtet haben, sind Sie auf dem besten Weg, eine großartige Java-Anwendung zu erstellen, die mit einer der Google Data APIs funktioniert.
Nächste Schritte Hier einige nützliche Links:
- Java-Eclipse-Plug-in für Google Data APIs
- Dokumentation zum Google-Datenprotokoll auf code.google.com
- Google Data Java-Clientbibliotheksprojekt
- Startleitfaden für die Java-Clientbibliothek
- JavaDoc-Dokumentation
Java ist eine Marke von Sun Microsystems, Inc. in den USA und anderen Ländern.