Themen. Web Service - Clients. Kommunikation zw. Web Services

Transkript

1 Themen Web Service - Clients Kommunikation zw. Web Services

2 Bisher: Implementierung einer Java Anwendung und Bereitstellung durch Apache Axis unter Apache Tomcat Java2WSDL Erzeugen einer WSDL-Datei zur Service-Beschreibung und Erzeugen der implementierenden Klassen durch Apache Axis WSDL2Java Die Grundlage, Web Services nutzen zu können, ist geschaffen Verwendung von Web Services in eigenen Anwendungen Implementierung von Web Service Clients

3 Kommunikation zw. Client und Web Service Mittels SOAP-Nachrichten Über HTTP (auch andere Protokolle) Client- Rechner Client- Programm 1 10 Web Service Implementierung Client- Stub Logische Kommunikation Server- Skeleton Server- Rechner SOAP- Nachricht Tatsächliche Kommunikation mittels HTTP SOAP- Nachricht

4 Apache Axis WSDL2Java Auflistung der von WSDL2Java erzeugten Klassen und Interfaces aus einer WSDL-Datei Quelle:

5 wsdl:types --> Java-Klassen Generell: pro Typ eine Klasse WSDL: <wsdl:types> <xsd:schema targetnamespace=" <xsd:element name="additionsparameter"> <xsd:complextype> <xsd:sequence> <xsd:element name="zahl1" type="xsd:int"/> <xsd:element name="zahl2" type="xsd:int"/> </xsd:sequence> </xsd:complextype> </xsd:element> <xsd:element name="additionresultat" type="xsd:int"/> </xsd:schema> </wsdl:types>

6 wsdl:types --> Java-Klassen Klassenname == type-name (CodeConv werden eingehalten) Source: package org.example. public class AdditionsParameter implements java.io.serializable { private int zahl1; private int zahl2; public AdditionsParameter() { } public AdditionsParameter(int zahl1, int zahl2) { this.zahl1 = zahl1; this.zahl2 = zahl2; } public int getzahl1() { return zahl1; } public void setzahl1(int zahl1) { this.zahl1 = zahl1; } public int getzahl2() { return zahl2; } public void setzahl2(int zahl2) { this.zahl2 = zahl2; } } // weitere Methoden

7 wsdl:types --> Java-Klassen Klassenname == type-name (CodeConv werden eingehalten) Besonderheit: Ist ein wsdl:type-element entweder inout- oder out-parameter, so wird eine zusätzliche Holder-Klasse generiert Holder-Klassen dienen dem schreibenden Zugriff auf Parameter Für primitive Datentypen (auch für Strings) existieren bereits Holder-Klassen (siehe javax.xml.rpc.holders.holder-interface)

8 wsdl:porttype --> Java-Interface (PortType) Service Definition Interface (SDI) WSDL: <wsdl:porttype name="meinservice"> <wsdl:operation name="addition"> <wsdl:input message="tns:additionrequest"/> <wsdl:output message="tns:additionresponse"/> </wsdl:operation> <wsdl:operation name="multiplikation"> <wsdl:input message="tns:additionrequest"/> <wsdl:output message="tns:additionresponse"></wsdl:output> </wsdl:operation> </wsdl:porttype> Source: package org.example. public interface MeinService_PortType extends java.rmi.remote { public int addition( org.example. additionrequest) throws java.rmi.remoteexception; public int multiplikation( org.example. additionrequest) throws java.rmi.remoteexception; }

9 wsdl:binding --> Java-Klasse (Stub) Implementierung des Service Definition Interface (SDI) Stub-Klasse dient als Stellvertreter (Proxy) des Web Service Stub-Objekt ist lokales Objekt auf der Client-Seite Erzeugt aus Methoden-Aufrufen auf einem Stub-Objekt SOAP- Nachrichten, die zum echten Web Service übertragen werden Stub-Objekte werden nicht vom Client selbst instanziert, sondern über Methodenaufruf des ServiceLocator (siehe nächste Folie) Wäre aber möglich

10 wsdl:binding --> Java-Klasse (Skeleton) Implementierung des Service Definition Interface (SDI) Schnittstelle zw. Axis Web-Service-Implementierung Skeleton-Klasse dient als Stellvertreter (Proxy) des Web Service Skelton-Objekt ist lokales Objekt auf der Server-Seite Dient Apache Axis als Stellvertreter-Klasse der Service Implementierung Requests an Axis werden an das Skeleton-Objekt weiter gegeben Skeleton ruft Methoden der Implementierenden Klasse auf Siehe nächste Folie (Java-Klasse (Impl))

11 wsdl:binding --> Java-Klasse (Impl) Implementiert die Operationen des Web Service addition(), multiplikation() Source: package org.example. public class MeinServiceSOAP1Impl implements org.example. public int addition(org.example. additionrequest) throws java.rmi.remoteexception { return additionrequest.getzahl1() + additionrequest.getzahl2(); } public int multiplikation( org.example. additionrequest) throws java.rmi.remoteexception { return additionrequest.getzahl1() * additionrequest.getzahl2(); }

12 wsdl:service --> Java-Interface Definiert verschiedene getter-methoden pro porttype (Dienst) wsdl:service --> Java-Klasse (ServiceLocator) Implementiert das o.g. Interface Wird auf Client-Seite verwendet, um Stub-Objekte zu instanzieren

13 Client aus generierten Klassen (Java Web Service) Request-Response-Client Instanziere ServiceLocator-Objekt (sl) Hole Dir vom SL ein Stub-Objekt (s) Rufe die Operation (Methode) auf dem Stub-Objekt auf Source: package org.example. import java.rmi.remoteexception; import javax.xml.rpc.serviceexception; public class ServiceClientWithSL { public static void main(string[] args) { MeinService_ServiceLocator sl = null; MeinService_PortType s = null; try { sl = new MeinService_ServiceLocator(); s = sl.getmeinservicesoap(); int response = s.addition(new AdditionsParameter(3,4)); System.out.println("Additions-Ergebnis: " + response); } // catch some Exceptions }}

14 Client mittels javax.xml.rpc.*; Folgt :o)