Anleitung zur Webservice Entwicklung unter Eclipse

Transkript

1 Entwicklungsumgebung installieren Sofern Sie nicht an einem Praktikumsrechner arbeiten, müssen Sie ihre Eclipse-Umgebung Webservice-fähig machen. Dazu benötigen Sie die Entwicklungsumgebung Eclipse for Java EE Developer, einen Webserver (Apache Tomcat 7.0) und ein Webservice-Framework für diesen Webserver (Axis ist standardmäßig in der obengenannten Entwicklungsumgebung enthalten). Erstellen eines Webservice in Eclipse 1. Als erstes muss ein Dynamic Web Project angelegt werden. Zu finden unter File New Other... oder wenn bereits die Perspektive ausgewählt ist, dann unter File New 2. Im nächsten Fenster muss ein Projektname eingegeben werde. Ich nenne es MyFirstWSProject.

2 3. Wählen Sie den Menüpunkt Target runtime New Runtime um den Server auszuwählen, falls Sie bereits einen Tomcat auf Ihrem System haben oder Ihn nun herunterzuladen und zu installieren. Im folgenden Fenster wählen Sie den Apache Tomcat 7.0 aus.

3 Wählen Sie Next um nun den Server auszuwählen.

4 Im folgenden Fenster muss nun die Location des Servers ausgewählt werden oder falls noch nicht vorhanden, kann der Server mit dem Button Download and Install heruntergeladen und installiert werden. Dieser wird dann an dem angegebenen Pfad installiert. Im Falle der Installation, haben Sie etwas Geduld bis der kleine Ladebalken unten rechts im Fenster der Entwicklungsumgebung fertig ist und wählen Sie dann Finish aus. 4. Nun wieder im Dynamic Web Project Fenster Finish auswählen. 5. Nun müssen wir eine Klasse erstellen, die später unser Web Service sein wird. Dazu rechtsklicken Sie auf das neu erstellte Projekt und wählen New Class. Als Namen wähle ich MyFirstWS. Sie sollten auch ein Paket angeben. Bestätigen Sie mit Finish.

5 6. Nun sollten wir dem Service eine Funktion hinzufügen: 7. Nun erstellen wir aus der Klasse einen Web Service. Dies machen wir in dem wir auf die Klasse rechtsklicken und den Punkt Web Services Create

6 Web Service wählen. Im folgenden Assistenten müssen Sie zuerst festlegen, bis zu welchem Grad der Web Service erstellt wird. Wollen Sie den Web Service erstellen und gleich testen, müssen Sie den Balken bis nach ganz oben schieben. In der Regel reicht die vorletzt Einstellung: Start Service. Klicken Sie auf Next. Das folgende Fenster, in dem eine service.xml erstellt werden soll, bestätigen Sie einfach mit Next. Nun soll der Web Server der Entwicklungsumgebung gestartet werden. Zum Starten einfach den Start

7 Server Button klicken. Nun sollte der Server gestartet 1 sein und Sie können mit Next weitermachen. Das nächste Fenster ermöglicht es Ihnen den Web Service zu testen. Dazu klicken Sie den Launch Button. In dem sich öffnenden Fenster kann der Web Service getestet werden. Dies wird über eine Weboberfläche gemacht, wo die einzelnen Methoden ausgeführt werden können. Im letzten Fenster des Assistenten kann nun noch der Web Service in eine UDDI Registry hinzugefügt werden, eine Art Gelbe Seiten -Server für Webservices. Diesen Punkt können Sie getrost überspringen. Schließen Sie den Assistenten mit Finish ab. 8. Wenn alles geklappt hat, befinden sich alle für den Web Service benötigten Dateien nun im WebContent Ordner. Die Datei MyFirstWS.wsdl beinhaltet die Schnittstellen Information des Webservices. Diese benötigt der Client als Vorlage, um die Stubklassen automatisch daraus zu generieren. Es kann vorkommen, dass der erstmalige Start des Servers scheitert. In diesem Fall müssen Sie den Server über die Servers -View stoppen und nochmals neu starten. Falls die Servers -View in Eclipse nicht angezeigt wird, können Sie sie über Window Show View anzeigen. Wählen Sie hier others und dann Servers. 1 Häufig gibt es hier einen Fehler, einfach den Server im Anschluss manuell noch einmal neu starten.

8 Erstellen eines Webservice-Clients Der erzeugte Webservice wird durch eine.wsdl Datei beschrieben. Die "Webservice Description Language"-Datei beschreibt dabei die einzelnen Serviceoperationen und ihre Ein-/Ausgabe-parameter. Darüber hinaus beschreibt sie auch den sogenannten Service-Endpunkt, d.h. wo der Dienst zu finden ist. Dieser Endpunkt wird durch eine URL ausgedrückt. Die Erstellung der passenden Stubklassen wird dadurch sehr einfach: 1. Kopieren Sie sich dazu die erzeugt.wsdl Datei in ein neues leeres Java Projekt. 2. Rechtsklicken Sie auf diese Datei und wählen Sie Web Services Generate Client

9 3. Ein Klick auf Finish erzeugt die benötigten Stubklassen, um die Methoden des Webservices aus einem Client heraus aufzurufen. Beachten Sie, dass Axis hier auch die packages entsprechend erzeugt und ggf. vorhandene Dateien überschreibt! Webservice verwenden Über die generierte Proxy-Klasse kann nun der Webservice angesprochen werden: Man kann auch einen alternativen Endpunkt im Konstruktor angeben, um z.b. den gleichen Dienst auf einem anderen Webserver ansprechen zu können: