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.
Service-Projekt erstellen
Die Erstellung eines Projektes