Diese Seite wurde von der Cloud Translation API übersetzt.

Codierung im Schatten: Eclipse mit Google Data APIs verwenden

Jeff Fisher, Google Data APIs-Team
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.

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.

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.

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.

Klicken Sie abschließend auf „Fertigstellen“ und erstellen Sie ein neues Projekt.

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.

Nun füge ich Code aus dem Entwicklerleitfaden für die Documents List API ein.

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.

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.

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.

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 ist eine Marke von Sun Microsystems, Inc. in den USA und anderen Ländern.