Projekt Entwicklung verteilter Softwaresysteme mit Web Services SoSe Java API for XML Web Service (JAX-WS) April 2008

Transkript

1 Projekt Entwicklung verteilter Softwaresysteme mit Web Services SoSe Java API for XML Web Service (JAX-WS) April 2008 Verteilte Systeme und Informationssysteme (VSIS) Department Informatik Universität Hamburg Einführung Java API for XML Web Service (JAX-WS) Java API zum Erstellen von Webservices Nachfolger von JAX-RPC - aktuelle Version: JAX-WS 2.1 Referenzimplementierung im Projekt Glassfish (JAX-WS RI) Verwendung von Annotationen zur Vereinfachung der Entwicklung und des Deployments von Webservice Clients und Service Endpunkten Tools zum Generieren von sog. Portable Artifacts und XML-Artefakten Laufzeitumgebung High-Level-API: Abstrakte Sicht auf Webservices ohne Details von SOAP, XML, usw. möglich Low-Level-API: Zugriff auf (XML-) Nachrichtenebene möglich Projekt: Entwicklung verteilter Softwaresysteme mit Web Services 2 1

2 JAX-WS Programmiermodell: High Level API Projekt: Entwicklung verteilter Softwaresysteme mit Web Services 3 Architekturübersicht Serverseitige Implementierung Projekt: Entwicklung verteilter Softwaresysteme mit Web Services 4 2

3 Programmiermodell High-Level-API Serverseitige Implementierung Bottom-up: 1. Implementierung des Service-Endpoint Interfaces (SEI) 2. Generieren von Portable Artifacts (WSDL, XSD) aus dem SEI (Tool: wsgen) 3. Deployment als.war-archiv Top-down: 1. Beschreibung des Webservices als WSDL-Datei 2. Generieren von Portable Artifacts (Proxy-Klassen) aus WSDL und XSD (Tool: wsimport) 3. Implementierung des Service-Endpoint Interfaces (SEI) 4. Deployment als.war-archiv Projekt: Entwicklung verteilter Softwaresysteme mit Web Services 5 Beispiel TestClient.java TestService.java - String dosometestoperation (TestObject to){ - TestService.wsdl - TestObject.xsd <testobject> <name>horst</name> <testobject> Answer Projekt: Entwicklung verteilter Softwaresysteme mit Web Services 6 3

4 Programmiermodell High-Level-API Serverseitige Implementierung Beispiel <?xml version="1.0" encoding="utf-8"?> <wsdl:definitions name="testservice" targetnamespace=" xmlns:tns=" xmlns:t= xmlns:soapenc=" xmlns:wsdl= xmlns:wsdlsoap=" xmlns:xsd=" <wsdl:types> <xsd:schema targetnamespace=" > <xsd:import namespace=" schemalocation="test.xsd"/> <xsd:element name="answer" type="xsd:string" /> </xsd:schema> </wsdl:types> <wsdl:message name="inmessage"> <wsdl:part name="testobject" element="t:testobject" /> </wsdl:message> <wsdl:message name="outmessage"> <wsdl:part name="answer" element="tns:answer" /> </wsdl:message>.. TestService.wsdl Projekt: Entwicklung verteilter Softwaresysteme mit Web Services 7 Programmiermodell High-Level-API Serverseitige Implementierung Beispiel TestService.wsdl <wsdl:porttype name="testserviceporttype"> <wsdl:operation name="dosometestoperation" > <wsdl:input message="tns:inmessage" /> <wsdl:output message="tns:outmessage" /> </wsdl:operation> </wsdl:porttype> <wsdl:binding name="testservicehttpbinding" type="tns:testserviceporttype"> <wsdlsoap:binding style="document" transport=" <wsdl:operation name="dosometestoperation"> <wsdlsoap:operation soapaction=""/> <wsdl:input> <wsdlsoap:body use="literal" /> </wsdl:input> <wsdl:output> <wsdlsoap:body use="literal" /> </wsdl:output> </wsdl:operation> </wsdl:binding>. Projekt: Entwicklung verteilter Softwaresysteme mit Web Services 8 4

5 Programmiermodell High-Level-API Serverseitige Implementierung Beispiel TestService.wsdl <wsdl:service name="testservice"> <wsdl:port binding="tns:testservicehttpbinding" name="testserviceport"> <wsdlsoap:address location=" </wsdl:port> </wsdl:service> </wsdl:definitions> Projekt: Entwicklung verteilter Softwaresysteme mit Web Services 9 Programmiermodell High-Level-API Serverseitige Implementierung XML Binding JAX-B: Java API for XML Binding Umwandlung von XML-Datentypen in Java-konforme Datentypen // Provide the namespace, otherwise it defaults to the package public class TestObject { TestObject.xsd private String name; <?xml version="1.0" encoding="utf-8"?> public String getname() { return name; public void setname(string value) { name = value; TestObject.java <xsd:schema targetnamespace=" xmlns=" xmlns:xsd=" <xsd:element name="testobject"> <xsd:complextype > <xsd:sequence> <xsd:element name="name" type="xsd:string" </xsd:sequence> </xsd:complextype> </xsd:element> </xsd:schema> Projekt: Entwicklung verteilter Softwaresysteme mit Web Services 10 5

6 Programmiermodell High-Level-API Serverseitige Implementierung XML Binding public class ObjectFactory { public TestObject createtestobject() { return new TestObject(); Projekt: Entwicklung verteilter Softwaresysteme mit Web Services 11 Programmiermodell High-Level-API Serverseitige Implementierung Beispiel eines Service-Endpoint name="testservice", targetnamespace=" servicename="testservice", portname="testserviceport", wsdllocation="web-inf/wsdl/testservice.wsdl" public class UserRegistrationService public String dosometestoperation(testobject to) { return new String("Test: " + to.getname()); Projekt: Entwicklung verteilter Softwaresysteme mit Web Services 12 6

7 Architekturübersicht Clientseitige Implementierung Projekt: Entwicklung verteilter Softwaresysteme mit Web Services 13 Programmiermodell High-Level-API Clientseitige Implementierung Dispatch: Aufrufen von Webdiensten ohne typsicheren Proxy Dynamic Proxy: 1. Generieren von Portable Artifacts aus einer WSDL-Beschreibung (Tool: wsimport) 2. Verwenden der generierten Proxy-Klassen zum Aufrufen des Webservices von einem beliebigen Endpunkt - Erzeuge Dienst - Hole Port-Proxy - Rufe Aktion im Port-Proxy auf Projekt: Entwicklung verteilter Softwaresysteme mit Web Services 14 7

8 Programmiermodell High-Level-API Clientseitige Implementierung mit Dynamic Proxy -- Beispiel public class TestClient static TestService service; public void dosomething() { // Create a Dynamic Proxy client service = new TestService(); TestServicePortType port = service.gettestserviceport(); // Use Proxy Instance as BindingProvider BindingProvider bp = (BindingProvider) port; // (Optional) Configure RequestContext with endpoint's URL Map<String, Object> rc = bp.getrequestcontext(); rc.put (BindingProvider.ENDPOINT_ADDRESS_PROPERTY, " TestObject to = new TestObject(); to.setname("horst"); String response = port. dosometestoperation(to) ; System.out.println(response); Projekt: Entwicklung verteilter Softwaresysteme mit Web Services 15 JAX-WS Programmiermodell: Low Level API Projekt: Entwicklung verteilter Softwaresysteme mit Web Services 16 8

9 Ausblick: Low Level APIs Aufbereitung und Zugriff auf Nachricht/Daten Annotierung und Implementierung von Provider<Source>, Provider<SOAPMessage> oder Provider<DataSource> Zugriff auf gesamte Nachricht oder Payload per PAYLOAD Beispiel: Zugriff auf public class ProviderImpl implements Provider<SOAPMessage> { public SOAPMessage invoke(soapmessage msg) { // do request processing SOAPMessage response =...; return response; Projekt: Entwicklung verteilter Softwaresysteme mit Web Services 17 Ausblick: Erweiterungen Projekt: Entwicklung verteilter Softwaresysteme mit Web Services 18 9

10 Deployment Projekt: Entwicklung verteilter Softwaresysteme mit Web Services 19 Deployment-Deskriptoren Konfiguration von Web-Applikationen allgemein: web.xml für JAX-WS Webservices: sun-jaxws.xml serverspezifisch: hier sun-web.xml Projekt: Entwicklung verteilter Softwaresysteme mit Web Services 20 10

11 Deployment-Deskriptoren: web.xml Beispiel web.xml <?xml version="1.0"?> <web-app version="2.5" xmlns=" xmlns:xsi=" xsi:schemalocation=" <!-- JAXWS Servlet Enddpoint --> <listener> <listener-class>com.sun.xml.ws.transport.http.servlet.wsservletcontextlistener</listener-class> </listener> <servlet> <servlet-name>wsservlet</servlet-name> <servlet-class>com.sun.xml.ws.transport.http.servlet.wsservlet</servlet-class> <load-on-startup>1</load-on-startup> </servlet> <servlet-mapping> <servlet-name>wsservlet</servlet-name> <url-pattern>/webservices/*</url-pattern> </servlet-mapping> </web-app> Projekt: Entwicklung verteilter Softwaresysteme mit Web Services 21 Beispiel sun-jaxws.xml Deployment-Deskriptoren: sun-jaxws.xml <?xml version="1.0" encoding="utf-8"?> <endpoints xmlns=" version="2.0"> <endpoint name="testservice" implementation="org.vsis.testservice" url-pattern="/testservice"/> </endpoints> Projekt: Entwicklung verteilter Softwaresysteme mit Web Services 22 11

12 Beispiel sun-web.xml <?xml version="1.0"?> <sun-web-app> Deployment-Deskriptoren: sun-web.xml <context-root>test</context-root> <servlet> <servlet-name>testservice</servlet-name> <webservice-endpoint> <port-component-name>testservice</port-component-name> <endpoint-address-uri>/testservice</endpoint-address-uri> <servlet-impl-class>org.vsis.testservice</servlet-impl-class> </webservice-endpoint> </servlet> </sun-web-app> Projekt: Entwicklung verteilter Softwaresysteme mit Web Services 23 Ant Werkzeug für die Automatisierung von Build- und Deploy-Vorgängen Steuerung über XML-Datei ("build.xml") Typische "Targets": build, create-war, clean build: Kompilieren und Zusammenfügen mit statischen Inhalten create-war: Erstellen einer installationsfertigen.war-datei clean: Entfernen der Produkte von build und deploy Projekt: Entwicklung verteilter Softwaresysteme mit Web Services 24 12

13 JAX-WS Tools mit Ant JAX-WS-Tools: apt: Verarbeitung der Annotationen wsgen: Generieren von XML-Artefakten wie WSDL und XML-Schemata wsimport: Generieren von Portable Artefacts (Port, Service Endpoint Interface, JAX-B-Mapper-Klassen) aus einer WSDL-Datei <target name="generate-client" depends="setup"> <wsimport debug="true" verbose="${verbose" keep="true" destdir="${basedir/src" package="org.vsis.client" wsdl=" </wsimport> </target> Beispiel: wsimport mit Ant (build.xml) Projekt: Entwicklung verteilter Softwaresysteme mit Web Services 25 Gesamte Struktur einer Web-Applikation.war-Datei: /build/dist/ Projekt: Entwicklung verteilter Softwaresysteme mit Web Services 26 13

14 Deployment und Ausführung Admin-Konsole auf Applikationen laufen auf Webservices laufen auf WSDL ist abrufbar auf Projekt: Entwicklung verteilter Softwaresysteme mit Web Services 27 Ende des Vorlesungsteils Viel Erfolg! Projekt: Entwicklung verteilter Softwaresysteme mit Web Services 28 14