Übersicht. Projekt DB-basierte, mobile Systeme. Übersicht. Was sind Web Services? Web Service - Kompakt. Warum das Rad neu erfinden?!

Transkript

1 Übersicht HTML Projekt DB-basierte, mobile Systeme JAX-RPC via SOAP Aufgabenblatt 4 Web Services Übersicht Was sind Web Services? "A web service is any service that is available over the Internet, uses a standardized XML messaging system, and is not tied to any one operating system or programming language." E. Cerami [1] "A Web service is a software system identified by a URI, whose public interfaces and bindings are defined and described using XML. Its definition can be discovered by other software systems. These systems may then interact with the Web service in a manner prescribed by its definition, using XML based messages conveyed by Internet protocols." W3C [2] Web Service - Kompakt Ein Web Service ist also ein Dienst, der über das Internet oder Intranets verfügbar ist, ein standardisiertes XML-Nachrichtensystem verwendet, programmiersprachen- & betriebssystemunabhängig ist, unter Verwendung einer XML-Grammatik selbst beschreibend ist und über einen einfachen Mechanismus auffindbar ist. Register Dienstnehmer Dienstanbieter Dienstbeschreibung abrufen Dienst auffinden Dienst aufrufen Warum das Rad neu erfinden?! Das Konzept hinter den Web Services ist nicht neu: CORBA, DCOM, DCE etc. können das doch auch! bisherige Ansätze sind meist sehr komplexe Standards und benötigen eine neue/eigene Infrastruktur sie sind gut für die Server-zu-Server Kommunikation sie bieten untereinander keine Interoperabilität Web Services verwenden die standardisierten Internetprotokolle Firewalls und Proxies können somit leicht durchdrungen werden es ist keine neue Infrastruktur notwendig Erprobtes wird verwendet sie sind gut für Client-to-Server Kommunikation sie sind untereinander voll interoperabel 1

2 Discovery Description XML XML Messaging Transport Der Web-Service-Protokollstapel UDDI UDDI SOAP, SOAP, XML-RPC HTTP, HTTP, SMTP, SMTP, FTP FTP Transport: Verantwortlich für den Nachrichtentransport zwischen den Anwendungen XML Messaging: Verantwortlich für die Kodierung der Nachrichten in XML Description: Verantwortlich für Beschreibung der öffentlichen Schnittstelle des Dienstes Discovery: Verantwortlich für das Zusammenfassen der Dienste in einer allgemeinen Registrierung und deren leichtes Einstellen und Auffinden. XML Messaging - SOAP SOAP: Simple Object Access Protocol plattformunabhängiges, zustandsloses und XML-basiertes Protokoll zum Austausch von Einwegnachrichten komplexere Kommunikationsformen können jedoch auf Basis dieser Einwegnachrichten erzeugt werden (request/response etc.) SOAP Nachrichten bestehen aus einem "Umschlag", einem optionalen Kopfteil und einem Nachrichtenkörper mit optionaler Fehlerbehandlung SOAP SOAP Envelope (required) SOAP Header (optional) SOAP Body (required) SOAP Fault (optional) SOAP über HTTP HTTP ist für den Transport von SOAP-Nachrichten nicht zwingend, wird aber päferiert. Erweiterung der HTTP-Header, um die Nachricht ohne Interpretation der SOAP-Daten schnell zu verarbeiten SOAPAction - Eine serverspezifische URI, welche die mit der Nachricht verbundene Absicht kennzeichnet. SOAPServer gibt in der Antwort an, welcher Server die Nachricht beantwortet. Die SOAP Nachricht wird als Nutzdaten in den HTTP-Nachrichten übertragen setzen des Content-Type auf text/xml Description - Web Services Description Language XML-Grammatik zur Beschreibung von Web Services ist Unabhängig von der verwendeten Plattform und Programmiersprache enthält Angaben zu: allen öffentlichen Funktionen des Dienstes (die Schnittstelle) den verwendeten Datentypen für Anfragen und Antworten dem zu verwendenden Transportmechanismus der physikalischen Adresse des Dienstes können automatisch generiert werden in a nutshell <definitions> Wurzelelement in in <types> Welche Datentypen werden übertragen? definitions Wurzel aller -Dokumente, definiert den Namen des Web Services und deklariert die verwendeten Namensräume -Elemente <messages> <porttype> <binding> <service> Welche Nachrichten gibt es? Welche Operationen/Funktionen werden unterstützt? Welches Transportprotokoll wird verwendet und wie sind dessen Details? Wo finde ich den Web Service? types definiert alle Datentypen, die zwischen Client und Server ausgetauscht werden die in der XML-Schema-Definition enthaltenen Basistypen wie string, integer etc. brauchen nicht extra deklariert werden message beschreibt eine Einwegnachricht, also eine einzelne Anfrage oder eine einzelnen Antwort enthält den Namen sowie die Parameter bzw. Rückgabewerte 2

3 -Elemente porttype kombiniert mehrere message-elemente zu einer Einweg- bzw. Frage/Antwort-Operationen binding beschreibt das konkrete Protokoll und Datenformat, das benutzt wird, um den porttype zu implementieren. enthält schon SOAP-Erweiterungen; es kann jedoch auch ein anderer Dienst genutzt werden service definiert die Adresse ("end-point"), über die der spezifizierte Service aufgerufen werden kann bei SOAP zum Beispiel eine URL <definitions name="helloservice" targetnamespace=" xmlns=" xmlns:soap="[]" xmlns:tns=" xmlns:xsd="[]" <message name="sayhellorequest"> <part name="firstname" type="xsd:string"/> </message> <message name="sayhelloresponse"> <part name="greeting" type="xsd:string"/> </message> <porttype name="hello_porttype> <operation name="sayhello"> <input message="tns:sayhellorequest"/> <output message="tns:sayhelloresponse"/> </operation> </porttype> <binding name="hello_binding" type="hello_porttype"> <soap:binding style="rpc" transport=" <operation name="sayhello"> <soap:operation soapaction="sayhello"/> <input> <soap:body encodingstyle=" namespace="urn:examples:helloservice" use encoded"/> </input> <output> [entsprechend] </output> </operation> </binding> <service name="hello_service"> <documentation> File for HelloService</documentation> <port binding="tns:hello_binding" name="hello_port"> <soap:adress location=" </port> </definitions> <definitions>: <definitions>: HelloService HelloService <messages>: 1) sayhellorequest(string:firstname) 2) sayhelloresponse:string <porttype>: sayhello Operation, bestehend aus Frage/Antwort Nachrichten <binding>: Aufruf mittels SOAP über HTTP <service>: verfügbar unter: 1. Definition der Schnittstelle in Java package helloservice; import java.rmi.remote; import java.rmi.remoteexception; Erstellen von Web Services mit J2EE public interface HelloIF extends Remote { public String sayhello(string str) throws RemoteException; Es muss zudem ein entsprechendes Home-Interface erstellt werden! 3

4 package helloservice; import java.rmi.remoteexception; import javax.ejb.sessionbean; import javax.ejb.sessioncontext; 2. Implementieren des Interfaces public class HelloServiceBean implements SessionBean { public String sayhello(string name) { return "Hello "+ name + " from HelloServiceBean"; public HelloServiceBean() { public void ejbcreate() { public void ejbremove() { public void ejbactivate() { public void ejbpassivate() { public void setsessioncontext(sessioncontext sc) { 3. Konfiguration definieren <?xml version="1.0"?> <configuration xmlns=" <service name="myhelloservice" targetnamespace="urn:foo/target" typenamespace="urn:foo/type" packagename="helloservice"> <interface name="helloservice.helloif" /> </configuration> Erzeugt später eine Datei mit dem Namen MyHelloService.wsdl wscompile -define -mapping./build/mapping.xml -d./build -nd./build -classpath./build -f:documentliteral config-interface.xml 4. Generieren der -Datei Erzeugt aus einem RMI-Interface eine -Datei Wo soll die Mapping- Datei hin? Wo sollen die Klassen-Dateien und andere Dateien hin? ACHTUNG: Die J2ME JAX- RPC-Implementierung kann nur diese Kodierung verstehen! /usr/remote/dbms/wscompile/wscompile wscompile 5. Generieren der Server-Klassen -gen:server -mapping./build/mapping.xml -d./build -nd./build -classpath./build -f:documentliteral config-interface.xml Erzeugt für die Methodenaufrufe des Interfaces entsprechende Request- und Response-Klassen und eine Klasse, die diese Klassen verknüpft. 6. Erstellen der webservices.xml <webservices xmlns=" xmlns:xsi=" xsi:schemalocation= " java.sun.com/xml/ns/j2ee version="1.1" > Beide URLs in einer Zeile und mit einem Leerzeichen getrennt... </webservices> <webservice-description> <webservice-description-name> HelloServiceSuite </webservice-description-name> <wsdl-file> META-INF/ INF/wsdl/MyHelloService.wsdl </wsdl-file> <jaxrpc-mapping-file> META-INF/ INF/wsdl/mapping.xml </jaxrpc-mapping-file> <port-component>... </port-component> </webservice-description> 6. Erstellen der webservices.xml Muss direkt unter META-INF liegen Wo im Archiv befinden sich später die Dateien 4

5 6. Erstellen der webservices.xml <port-component> <port-component-name>helloservice</port-component-name> <wsdl-port xmlns:wsns="urn:foo/target target"> wsns:helloifport </wsdl-port> <service-endpoint-interface> helloservice.helloif </service-endpoint-interface> <service-impl-bean> <ejb-link> link>helloservicebean</ejb-link> </service-impl-bean> </port-component> 7. -Datei anpassen ACHTUNG: Die Datei muss später dort liegen, <definitions name="myhelloservice" > wo es in der webservices.xml definiert wurde <service name="myhelloservice"> <port name="helloifport" binding="tns:helloifbinding"> <soap:address location= " </port> </definitions> Hier die URL eintragen, unter der der Service später erreichbar sein soll 8. Ergänzung in der ejb-jar.xml 9. sun-ejb-jar.xml <session> <ejb-name>helloserviceejb</ejb-name> <home>helloservice.hellohome</home> <remote>helloservice.helloremote</remote> <service-endpoint> endpoint> helloservice.helloif </service-endpoint> endpoint> <session-type>stateless</session type>stateless</session-type> </session> <webservice-description> <webservice-description-name> HelloWebService </webservice-description-name> </webservice-description> <ejb> <ejb-name>helloserviceejb</ejb-name> <jndi-name>ejb/somehellobean</jndi-name> <webservice-endpoint> <port-component-name> HelloService </port-component-name> <endpoint-address-uri> /aufg5/hello </endpoint-address-uri> </webservice-endpoint> </ejb> Eindeutiger Name vgl. ejb-jar.xml vgl. webservices.xml Relativer Pfad vom Web-Server-Root (vgl. -Datei) Ende 10. Pakete packen ;-) Nächstes Mal: J2ME-Programmierung Ansprechen des Web-Services vom Client aus ACHTUNG: mapping.xml nicht vergessen (Lage entsprechend des Eintrages in der webservice.xml) Zum Testen, ob der Web Service richtig eingerichtet wurde, einfach die Service Endpoint URL mit dem Parameter? aufrufen. 5