XML - Grundlagen, Prinzipien und Anwendungen

Veranstaltung im Sommersemester 2006

Aufgabe 11 - Zugriff auf einen Web Service mittels SOAP

Abgabe bis 3.7.2006

Aufgabenstellung

In dieser Übung soll mittels eines kleinen Java-Programms auf einen Web Service zugegriffen werden. Genauer: Durch das Versenden einer SOAP-Nachricht soll eine Methode eines Web Services aufgerufen und die erhaltene Antwort als Text ausgegeben werden.

Der dabei zu verwendende Web Service wird von Google zur Verfügung gestellt, um auf Suchdienste zugreifen zu können. Auf diese Art und Weise können die angebotenen Dienste sehr einfach in eigene Programme integriert werden.

Es existieren bereits Libraries für den Zugriff auf den Google Web Service in mehreren Sprachen wie Java und Perl. In dieser Übung geht es jedoch darum, den Zugriff ohne die Zuhilfenahme einer solchen Library zu realisieren. Auf diese Weise werden die zugrundeliegenden XML-Mechanismen deutlich, und man sieht auch gut, wie man selbst derartige Libraries entwickeln kann.

Vorbereitung

• Laden Sie die WSDL-Beschreibung des Google Web Services aus dem Internet herab und speichern Sie diese ab.
• Speichern Sie das Java-Rahmenprogramm lokal ab. Dies ist das Programm, welches Sie in dieser Übung erweitern müssen, um die Aufgabenstellung zu lösen.
• Registrieren Sie sich hier als Nutzer des Google Web Services. Google erteilt jedem Benutzer einen Key per e-mail. Diesen Key müssen sie bei jedem Service-Aufruf verwenden. Die Anzahl der Aufrufe ist pro Key und Tag auf 1000 beschränkt. In letzter Zeit gibt es manchmal Probleme mit der Registrierung, falls auch nach Aktivierung kein Mail mit dem Key zurück kommt, benutzt unseren Key: gpOX9vBQFHLYklshqTfN8ryZlPlN6uw7. (Da wie gesagt die Anzahl der Aufrufe beschränkt ist, bitte sparsam damit umgehen).

Vorgehensweise

Am besten erweitern Sie das Java-Programm in den folgenden Schritten:

• Beginnen Sie mit der Definition der SOAP-Envelope und des darin enthaltenen Bodys. Wichtig ist dabei vor allem das korrekte Setzen und Verwenden des SOAP-Namespaces.
• Betrachten Sie die Definition der doGoogleSearch-Methode im heruntergeladenen WSDL-Dokument. Fügen Sie das entsprechende Tag zum Aufruf dieser Methode in ihren SOAP-Request ein. Wichtig ist dabei vor allem das korrekte Setzen und Verwenden des entsprechenden Namespaces!
• Fügen Sie in den Aufruf die verschiedenen Parameter ein, welche sie dem WSDL-Dokument entnehmen können. Eine Beschreibung der Bedeutung der einzelnen Parameter finden Sie u.a. hier. Achtung: MaxResults darf nicht grösser als 10 sein!
• Wenn Sie die bisherigen Schritte alle richtig umgesetzt haben, sollte Ihr Java-Programm jetzt funktionieren, d.h. Sie sollten auf Ihre SOAP-Suchanfrage eine Antwort mit den Suchresultaten erhalten.
  • Compilieren des Programms:
    javac GoogleSoap.java
  • Starten des Programms:
    java GoogleSoap <Key> <Suchbegriff>
  • Achtung: Ihr müsst die Version 1.4.1 (oder höher) von Java verwenden, sonst geht es nicht!

Weitere Hinweise finden sie im Code des Java-Rahmenprogramms.

Abgabe

Schicken Sie ihr fertiges Java-Programm an den Betreuer.

please send comments to xml-vl@dret.net last modification on Tuesday, 27-Jun-2006 19:54:34 CEST