Читать книгу Web Services mit Apache CXF - Axel Eberhard Leistner - Страница 4

Dieses Tutorium beschreibt, wie ein Gästebuch als Web Service erstellt wird. Dabei verwenden wir die Werkzeuge Eclipse, Apache CXF und Apache Tomcat 7.0. Zunächst bauen wir einen Dienst auf dem Server auf. Zum Test der Funktionsweise des Gästebuch-Web-Services entwickeln wir dann eine Java-Client-Applikation, die den Web Service benutzt. Wir verfolgen den sogenannten Top-Down-Ansatz (WSDL-to-Java). Dabei wird zuerst die Service-Schnittstelle festgelegt und anschließend auf Basis dieser Schnittstelle die Service-Implementierung angelegt.

Dieses Tutorium setzt voraus, dass die Java JDK (hier: jdk1.7.0_17-64bit) und Eclipse (hier: eclipse-4.3“ aus eclipse-jee-kepler-M5-win32-x86_64) installiert ist, und dass weiterhin Eclipse korrekt mit Tomcat (hier: apache-tomcat-7.0.37-64bit) verbunden wurde. Dazu nehmen wir eine Basiskonfiguration innerhalb von Eclipse vor.

Eclipse bietet die Möglichkeit Zeilennummern für Quellentexte auszugeben. Wir wählen im Eclipse-Menü Window -> Preferences -> General -> Editors -> Text Editors aus und setzen den Haken beim Parameter Show line numbers. Drücken Sie dann auf den Schalter Apply am Ende des Fensters.

Abbildung 1: Editor in Eclipse konfigurieren - Zeilennummern

Eclipse hat bereits eine Java-Umgebung als Standardumgebung eingetragen. Wir wollen aber die von uns installierte JDK 1.7.0 Version 17 verwenden. Dazu legen wir nun eine neue Java JRE in Eclipse an: Wir wählen im Eclipse-Menü die Kombination Window -> Preferences -> Java -> Installed JREs aus. Drücken Sie auf den Schalter Add… (Abbildung 2) und danach im folgenden Fenster auf Standard VM und Next. Wählen Sie mit Hilfe des Schalters Directory… eine JRE-Home aus und jetzt klicken Sie auf den Schalter Finish (Abbildung 3).

Abbildung 2: Neue JRE einfügen

Abbildung 3: JRE-Umgebung auswählen

Aktivieren Sie das Feld neben dem Namen der zu verwendenden JDK-Version (Abbildung 4). Klicken Sie dann auf den OK-Schalter, um diese Einstellung bereits zu speichern. Vergessen Sie außerdem nicht, die Umgebungsvariable JAVA_HOME in den Systemeinstellungen zu setzen.

Abbildung 4: Installierte JRE in Eclipse auswählen

Wir drücken im Eclipse-Menü Window -> Preferences -> Server -> Runtime Environment den Schalter Add..., um die Tomcat-Umgebung einfügen zu können (Abbildung 5). Wählen Sie Server Apache -> Apache Tomcat 7.0. Klicken Sie auf Next (Abbildung 6).

Abbildung 5: Server Runtime Environments in Eclipse konfigurieren

Abbildung 6: Apache Tomcat v7.0 auswählen

Geben Sie das Tomcat- Installationsverzeichnis ein sowie die JRE-Umgebung. Klicken Sie dann auf den Schalter Finish (Abbildung 7). Damit ist in Eclipse die Tomcat-Umgebung spezifiziert (Abbildung 8). Setzen Sie unbedingt für Tomcat auch die Umgebungsvariable CATALINA_HOME in den Systemeinstellungen.

Abbildung 7: Tomcat- Installationsverzeichnis und JRE-Umgebung konfigurieren

Abbildung 8: Tomcat-Konfiguration in Eclipse

Nun wird noch das Werkzeug für die Erstellung des Web Services benötigt. Laden Sie Apache CXF 2.x aus dem Internet herunter. Danach entpacken Sie das Archiv (apache-cxf-2.7.2.zip oder eine neuere Version). Merken Sie sich unbedingt das Installationsverzeichnis. Setzen Sie auch die Umgebungsvariable CXF_HOME auf das Root-Verzeichnis der CXF-Installation.

Abbildung 9: CXF 2.x Preferences in Eclipse konfigurieren

Wir wählen im Eclipse-Menü Window -> Preferences -> Web Services -> CXF 2.x Preferences -> Add... aus (Abbildung 9). Geben Sie das Apache CXF-Installationsverzeichnis ein und jetzt klicken Sie auf den Schalter Finish. Wenn Sie die Umgebungsvariable CXF_HOME korrekt eingegeben haben, dann findet Eclipse die Version und den Type selbständig (Abbildung 10).

Abbildung 10: CXF- Installationsverzeichnis und Version konfigurieren

Aktivieren Sie das Kontrollfeld der Version des Apache CXF und klicken Sie auf Apply am Ende des Unterfensters (Abbildung 11).

Abbildung 11: CXF 2.x Preferences in Eclipse bestätigen

Die Konfiguration Java2WS ist zur Erstellung der WSDL-Datei gedacht, wenn man zuerst den Java-Code erstellt. Hier aktivieren wir die Schalter Generate Client und Generate Server (Abbildung 12).

Abbildung 12: Konfiguration für Java2WS

Für unsere Zwecke benötigen wir die Konfiguration WSDL2Java (Abbildung 13). Außerdem aktivieren wir die ersten fünf Schalter im Reiter JAX-WS zur JAX-WS Annotation Generation (Abbildung 14).

Abbildung 13: Konfiguration für WSDL2Java

Abbildung 14: Konfiguration für JAX-WS

Jetzt bereiten wir die Tools für den Einsatz in Eclipse vor. Wählen Sie dazu im Menü die Kombination mit der Folge Window -> Preferences -> Web Services -> Server and Runtime aus (Abbildung 15). Wählen Sie die Tomcat- sowie die Apache CXF-Umgebung in den beiden Auswahlfeldern aus, klicken Sie auf den Schalter Apply und danach auf den Schalter OK.

Abbildung 15: Tomcat-Server und CXF-Umgebung in Eclipse setzen

Öffnen Sie die Ansicht Servers im Eclipse-Menü mit der Kombination Window -> Show View -> Servers (Abbildung 16). Dann legen Sie einen neuen Server in dieser Server-View an. Klicken Sie in der View die rechte Maustaste an und wählen Sie New -> Server aus. Wählen Sie den Apache Tomcat v7.0 Server aus und jetzt klicken Sie auf den Schalter Finish.

Abbildung 16: Server in Eclipse aktivieren

Damit sind alle vorbereitenden Konfigurationen in Eclipse abgeschlossen.