SOAP. SOAP: Envelope

Transkript

1 SOAP Simple Object Access Protocol XML-basierter Nachrichtenaustauschmechanismus Projektbeginn 1998 (Microsoft). Heute: SOAP V1.2 W3C Recommendation Spezifikation umfasst: SOAP envelope Struktur eine SOAP Nachricht SOAP encoding Serialisierungsregeln für strukturierte Datentypen SOAP binding Framework Bindung an ein bestimmtes Transportprotokoll SOAP RPC Realisierung von RPC mittels SOAP Helmar Burkhart Webtechnologies (CS211) Lektion 11: Webservices SOAP: Envelope <xs:element name="envelope" type="tns:envelope" /> <xs:complextype name="envelope" > <xs:sequence> <xs:element ref="tns:header" minoccurs="0" /> <xs:element ref="tns:body" minoccurs="1" /> </xs:sequence> <xs:anyattribute /> </xs:complextype> Header Blöcke optional Body Block zwingend Namensraum: Helmar Burkhart Webtechnologies (CS211) Lektion 11: Webservices 11-22

2 SOAP: Verarbeitungsmodell SOAP Knoten sind für die Bearbeitungen der Nachrichten zuständig. SOAP Interaktion kann mehr als zwei Knoten betreffen. Initial SOAP sender (Client), SOAP intermediary, Ultimate SOAP receiver (Web Service) Jeder Knoten verarbeitet die Header Blöcke die seiner Rolle entsprechen und reicht die Nachricht weiter (role, mustunderstand, relay). Empfängerknoten bearbeitet Body und unadressierte Header Blöcke Helmar Burkhart Webtechnologies (CS211) Lektion 11: Webservices SOAP: Header Headerblöcke enthalten Daten für die Bearbeitung auf SOAP Knoten. Header spezifizieren durch role-attribut, wer diesen verarbeiten soll. Reservierte Rollen: Das mustunderstand Attribut legt fest ob der SOAP Knoten die Nachricht verstehen können muss. Helmar Burkhart Webtechnologies (CS211) Lektion 11: Webservices 11-24

3 SOAP: Body Body enthält Anwendungsdaten: Bsp. GoogleSearch <SOAP-ENV:Body> <ns1:dogooglesearch xmlns:ns1="urn:googlesearch" SOAP-ENV:encodingStyle= " <key xsi:type="xsd:string"> </key> <q xsi:type="xsd:string">shrdlu winograd maclisp teletype</q> <start xsi:type="xsd:int">0</start> <maxresults xsi:type="xsd:int">10</maxresults> <filter xsi:type="xsd:boolean">true</filter> <restrict xsi:type="xsd:string"></restrict> <safesearch xsi:type="xsd:boolean">false</safesearch> <lr xsi:type="xsd:string"></lr> <ie xsi:type="xsd:string">latin1</ie> <oe xsi:type="xsd:string">latin1</oe> </ns1:dogooglesearch> </SOAP-ENV:Body> Helmar Burkhart Webtechnologies (CS211) Lektion 11: Webservices SOAP: Fehlerbehandlung <xs:element name="fault" type="tns:fault" /> <xs:complextype name="fault" final="extension"> <xs:annotation> <xs:documentation>fault reporting structure </xs:documentation> </xs:annotation> <xs:sequence> <xs:element name="code" type="tns:faultcode" /> <xs:element name="reason" type="tns:faultreason" /> <xs:element name="node" type="xs:anyuri" minoccurs="0" /> <xs:element name="role" type="xs:anyuri" minoccurs="0" /> <xs:element name="detail" type="tns:detail" minoccurs="0" /> </xs:sequence> Helmar Burkhart Webtechnologies (CS211) Lektion 11: Webservices 11-26

4 SOAP Protokollbindung Umsetzung der SOAP Konzepte auf darunterliegendes Transportprotokoll Identifikation des Nachrichtenempfängers wird dem Transportprotokoll überlassen. SOAP HTTP SOAP over (SMTP) Helmar Burkhart Webtechnologies (CS211) Lektion 11: Webservices SOAP: RPC RPC Daten werden im SOAP Body übertragen Struktur entspricht den unter SOAP encoding vorgestellten Konzepten Voraussetzungen für RPC: URI des Empfängerknotens Funktions/Methoden Name Funktions/Methoden Signatur Funktionsparameter Helmar Burkhart Webtechnologies (CS211) Lektion 11: Webservices 11-28

5 SOAP: RPC Beispiel <env:envelope xmlns:env=" <env:body > <tmp:temp.gettemp_request> xmlns:tmp=" > <tmp:plz>4056</tmp:plz> </tmp:temp.gettemp_request> </env:body></env:envelope> <env:envelope xmlns:env=" <env:body > <tmp:temp.gettemp_response> xmlns:tmp=" > <tmp:datumzeit> </tmp:datumZeit> <tmp:tempcelsius>19.5</tmp:tempcelsius> </tmp:temp.gettemp_response> </env:body> </env:envelope> Helmar Burkhart Webtechnologies (CS211) Lektion 11: Webservices WSDL WSDL = Web Services Description Language XML-basiert Was? Um welchen Webservice handelt es sich, welche Funktionen werrdne erbracht: interface, porttype WIE? Wie erfolgt der Zugriff auf den Service: binding WO? Welcher URL kann eine Funktion aufrufen: service Helmar Burkhart Webtechnologies (CS211) Lektion 11: Webservices 11-30

6 WSDL: Dokumentaufbau <definition> <types> <message> <porttype> <binding> <port> <service> Logisches Wurzelelement, in welchem die verschiedenen Namespaces als Attribute definiert werden Datentypdefinitionen Abstrakte Definition der Nutzdatenpakete, die übertragen werden. Eine Nachricht (Message) entspricht auf dieser Ebene noch nicht einer Methode oder Funktion, wie man vielleicht meinen könnte. Fasst eine Menge von Operationen zusammen Erst hier werden konkrete Protokolle (SOAP, http-get, etc.) und Datenformate für Operationen und Nachrichten definiert. Spezifikation einer Adresse für eine Bindung Aggregation von zusammengehörigen Ports Helmar Burkhart Webtechnologies (CS211) Lektion 11: Webservices WSDL: Typen Die Standardtypen aus XML-Schema sind vorgegeben Eigene Typen können in diesem Types-Abschnitt analog zu XML-Schema und SOAP definiert werden. PositionsInfo_Request Temperatur_Response plz datumzeit tempcelsius Helmar Burkhart Webtechnologies (CS211) Lektion 11: Webservices 11-32

7 WSDL: Typen - Beispiel <wsdl:types> <xsd:schema targetnamespace= xmlns:xsd= > <xsd:element name= PositionsInfo_Request > <xsd:complextype> <xsd:sequence> <xsd:element name= plz type= string /> </xsd:sequence> </xsd:complextype> </xsd:element> <xsd:element name= Temperatur_Response > <xsd:complextype> <xsd:sequence> <xsd:element name= datumzeit type= datetime /> <xsd:element name= tempcelsius type= /> </xsd:sequence> </xsd:complextype> </xsd:element> </wsdl:types> Helmar Burkhart Webtechnologies (CS211) Lektion 11: Webservices UDDI White Pages Yellow Pages Green Pages Namensregister Anbieter- Auflistung Kontaktinformationen (Telefon, ,...) Branchenverzeichnis Suche nach Kategorie (Verkäufer,Dienstart,... ) Technische Details zu den Web Service 7 Helmar Burkhart Webtechnologies (CS211) Lektion 11: Webservices 11-34

8 UDDI UBR = UDDI Business Registry Die UBR ist eine logisch zentralisiertes, physisch aber verteiltes Service mit mehreren Wurzelknoten, die regelmäßig untereinander Daten austauschen Es genügt, wenn ein Service an einer beliebigen Instanz registriert wird, da diese die Registrierung nach oben hin weiterreicht. DNS-ähnlicher Aufbau der Informationsstruktur Helmar Burkhart Webtechnologies (CS211) Lektion 11: Webservices AXIS AXIS ist eine SOAP engine. Läuft als Servlet z.b. unter TOMCAT. Kann Java Klassen aus WSDL generieren. Einfache Webservices können direkt erzeugt werden (.jws). Komplexere mittels Web Service Deployment Descriptor (WSDD). Helmar Burkhart Webtechnologies (CS211) Lektion 11: Webservices 11-36

9 Google Web Service Develop Your Own Applications Using Google: 1.Download Developer s Kit 2.Create a Google Account 3.Write Program Using License key Helmar Burkhart Webtechnologies (CS211) Lektion 11: Webservices Google Beispiel String clientkey = args[0]; String directive = args[1]; String directivearg = args[2]; GoogleSearch s = new GoogleSearch(); s.setkey(clientkey); try { if (directive.equalsignorecase("search")) { s.setquerystring(directivearg); GoogleSearchResult r = s.dosearch(); System.out.println("Google Search Results:"); System.out.println("======================"); System.out.println(r.toString()); } else Helmar Burkhart Webtechnologies (CS211) Lektion 11: Webservices 11-38