Web Services und SOAP. Früher. Heute. Einführung. Kunde sucht sich auf dem Internet die Hotel, Flug und Mietwagenfirmen-Seiten

Transkript

1 Web s und Einführung Sie wissen, was ein Web ist Sie wissen, was ist Sie wissen, wie eine Meldung aufgebaut ist Sie können Meldungen mittels beschreiben Sie können einen Web Klient und Server implementieren 1 von 64 2 von 64 Früher Heute Kunde sucht sich auf dem Internet die Hotel, Flug und MietwagenfirmenSeiten?? Credit Credit Card Card Fluggesellschaft Fluggesellschaft Stellt sich ein passen Angebot zusammen Kunde Kunde html html Kunde Kunde html Virtuelles Virtuelles Reisebüro Reisebüro?? Schifffahrtslinie Schifffahrtslinie Bahn Bahn Hotel Hotel Mietwagen Mietwagen html Es braucht eine standardisierte, maschinell verarbeitbare Kommunikation zwischen Reisebüro und Dienstleistungsanbietern 3 von 64 4 von 64

2 Definition Web (nach W3C) (Web) Architektur Ein Web ist folgendermassen definiert A A Web Web service service is is a a software software system system igned igned to to supendpoint supendpoint interoperable machinetomachine interaction over a network. interoperable machinetomachine interaction over a network. It has an interface cribed in a machineprocessable format It has an interface cribed in a machineprocessable format (specifically (specifically ). ). Other Other systems systems interact interact with with the the Web Web service service in in a a manner manner prescribed prescribed by by its its cription cription using using messages, typically conveyed using with an messages, typically conveyed using with an serialization in conjunction with other Webrelated standards. serialization in conjunction with other Webrelated standards. Verwaltet Verwaltet Servîce Servîce Ermöglicht Ermöglicht das das Eintragen Eintragen von von s s Ermöglicht Ermöglicht das das Finden Finden von von Anbieter Anbieter Adressen Adressen anhand anhand unterschiedlicher unterschiedlicher Kriterien Kriterien Finde Binde Publiziere Bietet Bietet Dienste Dienste an: an: Teil Teil der der Geschäftslogik Geschäftslogik Beschreibt die angebotenen Dienste Beschreibt die angebotenen Dienste wie wie sind sind die die Dienste Dienste abrufbar? abrufbar? (Dienstleistungs)Vertragsinhalt (Dienstleistungs)Vertragsinhalt Publiziert Publiziert Dienste Dienste in in Beschreibt Dienste so, dass Kunden Beschreibt Dienste so, dass Kunden den Dienstanbieter finden können den Dienstanbieter finden können Zweck ist Interoperation zwischen Maschinen Schnittstelle beschrieben in maschinenlesbarer Form () Nachrichtenaustausch über Meldungen meist via oder anderen Web Protokollen meist unter Verwendung von in kodierten Nachrichten Web Konsument Konsument Konsumiert Dienste Anbieters Konsumiert Dienste Anbieters Sucht den gewünschten Dienst im Sucht den gewünschten Dienst im Stellt Verbindung mit dem Stellt Verbindung mit dem Dienstanbieter her und nimmt Dienst Dienstanbieter her und nimmt Dienst in Anspruch in Anspruch Beschreibung Beschreibung "Vertrag" "Vertrag" Anbieter Anbieter Ein Web ist eine Funktion (Prozedur,Methode, Teil der Geschäftslogik), die via Internet Technologien zugegriffen werden kann Daten werden meist in Format übermittelt 5 von 64 6 von 64 Web s Vor und Nachteile Standard für Nachrichtenaustausch unabhängig von Transportprotokoll unabhängig von Client und Implementierung: Java,.NET, PHP, Vorteile unabhängig von Programmiersprache, Laufzeitumgebung und Betriebssystem baut auf bestehender InternetInfrastruktur auf standardisiert von den grossen unterstützt/vorangetrieben (ABM und Microsoft) Web s Description Language SchnittstellenBeschreibung in Kommunikation auf Basis existierenden Protokolle und Serverarchitekturen und WebServer SMTP und MailServer FTP und FTPServer Nachteile Performance () Gremien mit dominanten Vertretern mit Partikulärinteressen Standards z.t. komplex, zu allgemein gehalten (Kompromiss standarts) Erweiterbarkeit führt zu Interoperabilitätsproblemen Standardisierung (W3C & I Gremium) 1.2, 1.1 (1.2 und 2.0) Zusätzliche Protokolle basierend auf und 7 von 64 8 von 64

3 Web s : Simple Object Access Protocol Definiert ein StandardFormat für den Transport von Daten, via, SMTP und FTP für den Zugriff auf Web s : Web Description Language Beschreibt die Schnittstelle eines Web (Ein/Ausgabe Parameter, Protokoll Bindung, etc.) UDDI: Universal Description, Discovery, and Integration (Weltweites) von Web s in dem nach verschiedenen Kriterien gesucht werden kann Finde UDDI UDDI Publiziere Konsument Klient Klient Request Response Fassade Fassade Geschäfts Geschäfts Logik Logik Anbieter 9 von von 64 Basis Web Stack Erweiterter Web Stack Architektur Beschreibung Beschreibung Messaging Messaging Transport Transport Netzwerk Netzwerk Web s UDDI UDDI,, SMTP, SMTP, stellt für Web s zur Verfügung ermöglicht das Eintragen von s (Publikation) ermöglicht Finden von Adressen anhand folgender Kriterien Weisse Seiten: nach Namen Gelbe Seiten: nach Branchen Grüne Seiten: Beschreibung der Dienstleistung beschreibt die Schnittstelle Web s in maschinenlesbarer Form unabhängig von Programmiersprache beschreibt, welcher Transportmechanismus verwendet wird* beschreibt, wo der zu finden ist* definiert das Meldungsformat meistens Format ( basiert) unabhängig von BS kann Transport Netzwerk verwenden (gebunden werden) stellt Transportmechanismus für Daten zur Verfügung im Internet: basiert auf bestehenden Internet Protokollen: http, smtp, ftp im Intranet: auch andere Protokolle möglich: MQ *Design Fehler In konkreten Anwendungsfall von Web s sind Erweiterungen notwendig für Sicherheit, Transaktionssteuerung, etc. Werden angeboten vom Anbieter Infrastruktur ( Microsoft, IBM, Open Source) Standards z.t. noch nicht etabliert > proprietäre, z.t. nicht interoperable Lösungen Anwendung Anwendung Messaging Messaging API API.NET, JAX.NET, JAX Messaging Messaging Transport, SMTP, FTP Transport, SMTP, FTP Network Network Transport Transport Layer Layer TCP/IP TCP/IP Beschreibung Beschreibung UDDI. UDDI. Workflow, Workflow, BPEL, XLANG(MS) BPEL, XLANG(MS) Sicherheit Sicherheit Security Security Transaktionen Transactions Transaktionen Transactions Zuverlässigkeit Zuverlässigkeit Reliable Messaging Reliable Messaging Addressierung Addressierung Adressing Adressing Binäre Binäre Anhänge Anhänge Attachement Attachement 11 von von 64

4 * Konkret Stand der Implementierung (Ende 2008) Federation Federation Secure Secure Conversation Conversation Trust Trust Security Security Transfer Transfer Infoset Infoset Management Management Reliable Reliable Messaging Messaging Enumeration Enumeration Addressing Addressing Namespaces Namespaces Devices Devices Profile Profile Business Business Activity Activity Atomic Atomic Transaction Transaction Coordination Coordination Eventing Eventing MTOM MTOM MIME MIME Step 2 Workshops & Community Dev Step 2 Workshops & Community Dev Step 3 Standardization Step 3 Standardization Step 4 Approved Standard Step 4 Approved Standard Infrastructure Infrastructure and and Profiles Profiles Assurances Assurances Messaging Messaging / / UDP UDP / / Metadata Metadata Metadata Metadata Exchange Exchange Discovery Discovery UDDI UDDI Policy Policy Schema Schema Foundation Foundation einfaches Nachrichtenformat in für Verpackung beliebiger Anwendungsdaten einzelne Nachrichten ( oneway ) Unabhängig vom Transportprotokoll ist erweiterbar Sicherheit Authentifikation etc. Verschiedene Meldungsaustauschmuster durch kombination einzelner Nachrichten (Message Exchange Patterns) oneway, requestresponse Client Client 1: GetTime_Request 2: GetTime_Response Server Server 13 von von 64 Funktionsweise von über Interaktionsmodelle Client <soapenv:envelope> <m:getstockprice> <Stock>INTC</Stock> </m:getstockprice> </soapenv:body> Response ( : 200 OK) <soapenv:envelope> <m:getstockpriceresponse> <Price>34.5</Price> </m:getstockpriceresponse> </soapenv:body> Request (:POST) Beispiel RequestResponse Beispiel RequestResponse StockQuote One Way: /SMTP Einweg Kommunikation: nur unbestätigte Aufruf Meldung vom Klient zum Web RequestResponse: / (hier behandelt) Synchrone Kommunikation: Aufruf Meldung vom Klient zum Web mit Antwort vom Web Solicit Response: /SMTP Asynchrone Kommunikation: einzelne unbestätigte Aufruf Meldung vom Klient zum Web, dann unbestätigte Antwort zurück Notification: POP3 Benachrichtigung: einzelne unbestätigte Meldung vom Web zum Klient Client Web 15 von von 64

5 Aufbau einer Meldung POST/objectURI /1.1 Action soapenv:envelope soapenv:header Objekt Endpunkt Objekt Identifikation Methoden Identifikation Informationen für den Transport der Nachricht Informationen für den/die Empfänger der Nachricht Meldungen Header 1 Header 2 Erweiterungskopfteil Meldungsdaten Daten Informationen über die Daten der Nachricht, Unterschrift, etc. soapenv:body Daten Logische Aufteilung Daten der Nachricht Nachricht 17 von von 64 Beispiel: Aufbau einer Meldung Header Header Header (def: (def: ) ) POST /Accounts /1.1 Host: webservicebank.com ContentLength: nnnn ContentType: text/xml xml; charset=" ="utf8" Action: : "SomeURI" <:Envelope xmlns:=" :=" :encodingstyle encodingstyle=" =" <:Header> <t:signature xmlns:t="someuri" :mustunderstand mustunderstand="1"> </t:signature> </:Header> <:Body> <m:deposit xmlns:m="someuri"> <acctnumber> </ > </acctNumber> <amount>200</amount> Body Entry </m:deposit> Body Entry (def:applikation) </:Body> (def:applikation) </:Envelope> Envelope Envelope (def: ) (def: ) Header Header (def:,opt) (def:,opt) Header Entry Header Entry (def:applikation) (def:applikation) Body Body (def:) (def:) POST Aufruf meist über POST ContentType: text/xml und charset=utf8 (Unicode variabler Länge) Host: ZielMaschinenname Action: für Routing und Dispatching von Meldungen Request ab 1.2 nicht mehr verwendet, da nur für gültig Action: "" bei POST wird direkt der Endpunkt s angegeben POST /axis/services/my /1.0 POST /axis/services/my /1.0 ContentType: text/xml; charset=utf8 ContentType: text/xml; charset=utf8 Host: localhost Host: localhost Action: "" Action: "" ContentLength: 414 ContentLength: 414 Response / OK / OK ContentType: text/xml; charset="utf8" ContentType: text/xml; charset="utf8" ContentLength: 564 ContentLength: von von 64

6 Aufruf (GETPOST) Beispielaufruf via GET bzw. POST Aufruf über GET Aufruf kodiert (URLencoded) Response kodiert Einschränkung auf einfache Aufrufe (keine HeaderEinträge, keine strukturierten Daten) Aufruf von GetTime(bool shortform) bei Web Aufruf : Aufruf über POST Datenteil POSTRequest enthält kodierte Anfrage Antwort kodiert ohne Einschränkungen Response: /1.1 / OK OK ContentType: ContentType: text/xml; text/xml; charset=utf8 charset=utf8 ContentLength: ContentLength: length length <?xml <?xml version="1.0" version="1.0" encoding="utf8"?> encoding="utf8"?> <string <string xmlns=" 21 von von 64 Envelope Header Envelope Element definiert in Namespace: ://schemas.xmlsoap.org/soap/envelope/ beinhaltet KindElemente Header: Kopfteil (optional) : Informationen über die Meldung Body: Daten (Payload) Fault: als Teil von Body (optional) bei Fehler <soapenv:envelope xmlns:soapenv soapenv=" =" ://schemas.xmlsoap.org/soap/envelope/" xmlns:xsd=" Envelope Envelope Namespaces Namespaces xmlns:xsi=" <soapenv:header> </soapenv soapenv:header> <soapenv:fault> Schema Namespaces Schema Namespaces </soapenv soapenv:fault> </soapenv soapenv:body> </soapenv soapenv:envelope> Kann verwendet werden um anwendungsspezifische Information zur Meldung hinzuzufügen, z.b. Authentisierung, Transaktionssteuerung wird dem Body vorangestellt Ermöglicht das "piggybacking" von Metainformation (Information über Daten) zusätzliche (Status) Informationen Sicherheit, etc. Wird von der Infrastruktur interpretiert <soapenv:envelope xmlns:soapenv=" <soapenv:envelope xmlns:soapenv=" xmlns:xsd=" xmlns:xsd=" xmlns:xsi=" xmlns:xsi=" <:Header soapenv:encodingstyle=" <:Header soapenv:encodingstyle=" <t:signature xmlns:t=" :t="someuri" <t:signature xmlns:t="someuri" :mustunderstand mustunderstand="1" xsi:type="xsd:string"> :mustunderstand="1" xsi:type="xsd:string"> </t:signature Signature> </t:signature> </:Header Header> </:Header> 23 von von 64

7 Body Die Datenformat im <Body>Element Im Body werden die eigentlichen Daten übertragen Daten im <Body> Element sind grundsätzlich frei wählbar (wellformed ) Meist jedoch durch Schema definierte Struktur literal: literal: onthewire onthewire Format Format in in einem einem Schema Schema definiert definiert (exact) (exact) encoded: encoded: onthewire onthewire Format Format entspricht entspricht nicht nicht dem dem Schema Schema sondern sondern dem dem definierten definierten Encoding Encoding z.b z.b Endcoding Endcoding Request <soapenv:envelope xmlns:soapenv=" <soapenv:envelope xmlns:soapenv=" xmlns:xsd=" xmlns:xsd=" xmlns:xsi=" xmlns:xsi=" <soapenv:header <soapenv:header document: document: Übermittlung Übermittlung eines eines Dokuments Dokuments <soap:envelope> <soap:envelope> <soap:body> <soap:body> <mymethoddata> <mymethoddata> <x>5</x> <x>5</x> </mymethoddata> </mymethoddata> </soap:body> </soap:body> </soap:envelope> </soap:envelope> <soap:envelope> <soap:envelope> <soap:body> <soap:body> <mymethoddata> <mymethoddata> <x xsi:type="xsd:int">5</x> <x xsi:type="xsd:int">5</x> </mymethoddata> </mymethoddata> </soap:body> </soap:body> </soap:envelope> </soap:envelope> <m:deposit xmlns:m=" :m="someuri"> <m:deposit xmlns:m="someuri"> <acctnumber> </ > </acctNumber> <acctnumber> </acctnumber> <amount>200</ >200</amount> <amount>200</amount> </m:deposit Deposit> </m:deposit> </soapenv:body Body> </soapenv:body> Response rpc: rpc: Aufruf Aufruf einer einer Funktion Funktion <soap:envelope> <soap:envelope> automatisch <soap:body> automatisch <soap:body> <mymethod> <mymethod> <x>5</x> <x>5</x> </mymethod> </mymethod> </soap:body> </soap:body> </soap:envelope> </soap:envelope> <soap:envelope> <soap:envelope> <soap:body> automatisch <soap:body> automatisch <mymethod> <mymethod> <x xsi:type="xsd:int">5</x> <x xsi:type="xsd:int">5</x> </mymethod> </mymethod> </soap:body> </soap:body> </soap:envelope> </soap:envelope> 25 von von 64 Die Daten im <Body>Element Serialisierung von Datenstrukturen Nachrichtenformat: rpc Methodenname als Teil der Meldung Abbildung der einfachen Datentypen der Programmiersprache folgende Abbildungsregeln (=Binding) werden für Java angewandt JAXBCompatible Type Mapping document Methodenname nicht Teil der Meldung Kodierung: literal Daten werden nach einem Schema kodiert encoded Daten werden nach Regeln (Section 5) kodiert übliche Kombinationen: document/literal die heute am häufigsten verwendetes Format, beste Interoperabilität rpc/literal verwendet bei Java Umfeld, weniger Hilfs/Wrapper Klassen rpc/encoded früher häufig verwendet von von 64

8 Serialisierung von Datenstrukturen Serialisierung von Datenstrukturen Einfache Datentypen werden einfach in Elemente abgebildet ElementName = Variablen Name ElementInhalt = Wert Typ durch XSD Schema definiert xsi:type= xsd:string xsi:type= xsd:string singlereference und "nested" Strukturen (Klassen) werden eingebettet <e:book> <title>my Life and Work</title> <author> <name>henry Ford</name> <address> < >mailto:henryford@hotmail.com</ > <web> </address> </author> </e:book> <title> My Life and Work </title> <price> </price> xsi:type= xsd:float xsi:type= xsd:float Arrays und Listen einfach als Sequenz von gleichen Elementen Andere Andere Collections Collections problematisch problematisch multireference Strukturen verwenden id & href attributes <e:books> <e:book> <title>my Life and Work</title> <author href="#person1" </e:book> <e:book> <title>the Success of Tin Lizzy</title> <author href="#person1" </e:book> </e:books> <e:person id="person1"> <name>henry Ford</name> <address> < >mailto:henryford@hotmail.com</ > <web> </address> </e:person> 29 von von 64 Konsequenzen litteral Formats Fault Body Daten sind durch Schema bzw. beschrieben Vorteil: Meldung kann mit Schema validiert werden Nachteil: Bei nicht Baum Daten Strukturen komplex (Z.B. Graphen, Mehrfachreferenzen) <?xml version="1.0"?> <?xml version="1.0"?> <xsd:schema> <xsd:schema> <xsd:complextype name="arg"> <xsd:complextype name="arg"> <xsd:sequence> <xsd:sequence> type="xsd:" name="arg0" type="xsd:" name="arg0" type="xsd:" name="arg1" type="xsd:" name="arg1" </xsd:sequence> </xsd:sequence> </xsd:complextype > </xsd:complextype > name="op1" type="listing3:op1type" name="op1" type="listing3:op1type" <arg> <arg> <arg0>20.0</arg0> <arg0>20.0</arg0> <arg1>22.0</arg1> <arg1>22.0</arg1> </arg> </arg> </soapenv:body> </soapenv:body> Fault: Ein Fehler ist aufgetreten erstes/einziges Element von Body faultcode: Klassifizierung Fehlers MustUnderstand (Header with mustunderstand=1 nicht verstanden) VersionMismatch (falsche namespace) Client (Fehler in request Meldung vom Klienten) Server (Fehler auf der Server Seite) faultstring/detail: Beschreibung Fehlers Result: Result: / Internal Server Error ContentType: text/xml; charset=utf8 <soapenv:envelope > <soapenv:fault> <faultcode>ns1:server.userexception</faultcode> <faultstring>java.rmi.remoteexception: Overflow</faultstring> <detail><ns2:stacktrace xmlns:ns2=" at calc.calculatorsoapbindingimpl.add(calculatorsoapbindingimpl.java:12) </detail> </soapenv:fault> </soapenv:body> 31 von von 64

9 Fragen und Fakten zu Wieso sollte man kennen? StandardBeschreibungssprache für Web Schnittstellen finden von Interoperabilitätsproblemen beschreibung mit Wieso ist so kompliziert? früh entwickelt (noch bevor XSD fertig definiert war) grosse Allgemeinheit abgedeckt (Protokolle, Aufrufmodelle, etc.) Werkzeuge zur Erstellung Texteditor: ziemlich mühsam (sollte man aber einmal gemacht haben) mit graphischen Werkzeugen: einfacher aber kein Standard, z.b. Spy Finden von die meisten Web Implementationen liefern Schnittstelle (automatisch) <Web URL>? se auf dem Internet (siehe Anhang) 33 von von 64 Schnittstellen Beschreibung Web Description Language () Funktionen einer Schnittstellen Beschreibungssprache (IDL) von Menschen lesbar und erstellbar Definition der Schnittstelle (SW Engineering zuerst) "interface first" Ansatz Dokumentation von Maschine lesbar zur Laufzeit: überprüfen ob Daten mit Schnittstelle konform(validierung) zur Entwicklungszeit: Generierung von Hilfsklassen Implementierungsrumpf für Web s Stub (Stumpf) für den Aufruf ist basierte IDL für Webs in wird beschrieben: Interface Verwendete Datentypen Aufbau einzelner Nachrichten Operationen (Methoden) Implementation Protokolle um Operationen aufzurufen Adressen für Web Web Definition Language März 2001 definiert Version 2.0 (früherer Name = 1.2) seit Juni 2007 W3C Recommendation Umbenennung: Port>Endpoint; definition > cribtion; Interface> Interface Elimination von Message (> wird zu XSD Complex Type) 35 von von 64

10 Struktur eines Dokuments Aufbau eines Dokuments Struktur eines Dokuments (von 1.1 zu 2.0) message > x porttype > interface port > endpoint EndPoint z.b. z.b. + + Operation Verwendung Verwendung von von Schema Schema Type/ Element EndPoint Binding (Interface) Interface (abstraktes Interface) Operation request/ response Types Type/ Element Type/ Element EndPoint Operation Web Protokoll Operationen abstraktes Interface Typen & Elemente von von 64 Aufbau eines Dokuments Grundstruktur von 2.0 Type/Element Definiert Typen und Strukturen als Schema Request/Response Data Strukture Type definieren wie die Typen verwendet werden Operation verknüpft 2 (1) Meldung: requestresponse Interface verknüpft mehrere Operationen zu einem abstrakten Interface Binding fügt protokollspezifische Information zu Interface hinzu EndPoint ist die Schnittstelle eines Web s (instance) (Web) kann verschiedene Schnittstellen (EndPoints) haben Web Protokoll abstraktes Interface 39 von 64 <definitions> <types> <xsd;> </xsd:> <xsd:complextype> </xsd:complextype> </types> <interface> <operation> <input> <output> </operation> </interface> <binding> <operation> </binding> <service> <endpoint> </service> </definitions> Beschreibung eines Webs Typen beschrieben in <xsd:schema> einzelne Nachrichten Teile der Nachricht InterfaceBeschreibung Operationen eines Interfaces InputNachricht OutputNachricht Binden von Interfaces an Protokolle + Kodierung Beschreibung der Anbindung für jede Operation beschreibung URI und Anbindung für Endpoint abstrakter Teil konkreter Teil 40 von 64

11 Beispiel Abstrakter Teil Beispiel Konkreter Teil Types Abschnitt der häufig in separate XSD Datei und mittels <include> hineingenommen <cription xmlns=" xmlns:tns=" xmlns:whttp=" xmlns:wsoap=" targetnamespace=" <! Abstract types > <types> <xs:schema xmlns=" xmlns:xs=" targetnamespace=" <xs:element name="request"> <xs:complextype> <xs:sequence> <xs:element name="header" maxoccurs="unbounded"> <xs:complextype> <xs:simplecontent> <xs:extension base="xs:string"> <xs:attribute name="name" type="xs:string" use="required" </xs:extension> </xs:simplecontent> </xs:complextype> <xs:element name="body" type="xs:anytype" minoccurs="0" </xs:sequence> </xs:complextype> <xs:element name="response"> <xs:complextype> <xs:sequence> <xs:element name="header" maxoccurs="unbounded"> <xs:complextype> <xs:simplecontent> <xs:extension base="xs:string"> <xs:attribute name="name" type="xs:string" use="required" </xs:extension> </xs:simplecontent> </xs:complextype> <xs:element name="body" type="xs:anytype" minoccurs="0" </xs:sequence> </xs:complextype> </xs:schema> </types> <! Abstract interfaces > <interface name="timer"> <operation name="gettime" pattern=" <input messagelabel="getmsg" element="tns:request" <output messagelabel="successfulmsg" element="tns:response" </operation> </interface> Konkreter Teil beschreibt das verwendete Protokoll für jede einzelne Operation heute oft auch noch REST Binding beschreibt die URL Endpoints oft Ursache von Problemen (später) <! Concrete Binding Over > <binding name="interfacehttpbinding" interface="tns:interface" type=" <operation ref="tns:gettime" whttp:method="post" </binding> <! Web offering endpoint > <service name="time" interface="tns:timer"> <endpoint name="soapendpoint" binding="tns:interfacehttpbinding" address=" public class Timer public public String gettime(string format) public String gettime(string format) 41 von von 64 Aufbau eines Dokuments Struktur <wsdl:definitions <wsdl:definitions name="calculator" name="calculator" targetnamespace=" targetnamespace=" Namesspaces xmlns:wsdl=" Namesspaces xmlns:wsdl=" xmlns:wsdlsoap=" xmlns:wsdlsoap=" xmlns:xsd=" xmlns:xsd=" xmlns:impl=" xmlns:impl=" import > zusätzlicher Schemas import > zusätzlicher Schemas <xsd:schema> <xsd:schema> <xsd:import> <xsd:import> namespace="" namespace="" location location = = "" "" <xs:element <xs:element name="request" name="request" name="addresponse"> name="addresponse"> </xs:element </xs:element > > Binding <xs:element <xs:element name="response"> Binding definiert definiert name="response"> endpoint endpoint Typ: Typ:.. Interface Interface </xs:element </xs:element > > <wsdl:interface <wsdl:interface name="calculator"> name="calculator"> </wsdl:interface> </wsdl:interface> <wsdl:binding <wsdl:binding name="calculatorsoapbinding" name="calculatorsoapbinding" type="impl:calculator"> type="impl:calculator"> endpoint endpoint fügt fügt prot. prot. </wsdl:binding> </wsdl:binding> abh. abh. Bindung Bindung hinzu hinzu <wsdl:service <wsdl:service name="calculator"> name="calculator"> <wsdl:endpointbinding="impl:calculatorsoapbinding" <wsdl:endpointbinding="impl:calculatorsoapbinding" name="calculator"> name="calculator"> </wsdl:endpoint> </wsdl:endpoint> </wsdl:service> </wsdl:service> </wsdl:definitions> </wsdl:definitions> mit mit EndPoints EndPoints Web Protokoll abstraktes Interface 43 von 64 Interface Typen & Elemente Die Typen und Elemente werden mittels Schemas beschrieben Deklaration der Typen, die in Aufruf verwendet werden add( a, b) <xsd:schema <xsd:schema targetnamespace=' targetnamespace=' xmlns:xsd=' xmlns:xsd=' xmlns:typens=' xmlns:typens=' name="op1" name="op1" type="xsd:" type="xsd:" name="op2" name="op2" type="xsd:" type="xsd:" name="result" name="result" type="xsd:" type="xsd:" <arg0 xsi:type="xsd:">20.0</arg0> <ns1:add xmlns:ns1=" <ns1:add xmlns:ns1=" <arg0 xsi:type="xsd:">20.0</arg0> <arg1 xsi:type="xsd:">22.0</arg1> <arg1 xsi:type="xsd:">22.0</arg1> </ns1:add> </ns1:add> </soapenv:body> </soapenv:body> 44 von 64

12 Interface Typen & Elemente Komplexe Typen Einbezug von externen Schemas Es können eigene Typen definiert werden Grundsätzlich voller XSD Umfang, aber meist nicht vollständig implementiert Oft besser Datentypen nicht in sondern in externen Schemas zu definieren können in mehreren verwendet werden übersichtlicher Werkzeugunterstützung <xsd:schema <xsd:schema targetnamespace=' targetnamespace=' xmlns:xsd=' xmlns:xsd=' xmlns:typens=' xmlns:typens=' <xsd:simpletype <xsd:simpletype name="op1type"> name="op1type"> <xsd:restriction <xsd:restriction base="xsd:" base="xsd:" </xsd:simpletype> </xsd:simpletype> name="op1" name="op1" type="typens:op1type" type="typens:op1type" 45 von 64 <?xml version="1.0"?> <?xml version="1.0"?> <xsd:schema targetnamespace="urn:listing3" <xsd:schema targetnamespace="urn:listing3" xmlns:xsd=" xmlns:xsd=" <xsd:import namespace=" <xsd:import namespace=" <xsd:simpletype name="op1type"> <xsd:simpletype name="op1type"> <xsd:restriction base="xsd:" <xsd:restriction base="xsd:" </xsd:simpletype> </xsd:simpletype> name="op1" type="listing3:op1type" name="op1" type="listing3:op1type" <xsd:schema <xsd:schema targetnamespace=' targetnamespace=' xmlns:xsd=' xmlns:xsd=' xmlns:typens=' xmlns:typens=' <xsd:import <xsd:import namespace="urn:listing3" namespace="urn:listing3" schemalocation="listing3.xsd" schemalocation="listing3.xsd" name="op1" name="op1" type="listing3:op1type" type="listing3:op1type" 46 von 64 Interface message und part abstraktes Interface Interface Definition wie die Typen verwendet werden: fasst definierte Typen zu Meldungen zusammen entspricht in Java der Liste der formalen Parameter in Methode: [] add([ a, b]) es können auch direkt XSD Typen verwendet werden: element="xsd:" Name Name Meldungstyp Meldungstyp Types <xsd:schema > <xsd:schema > name="op1" type="xsd:" name="op1" type="xsd:" name="op2" type="xsd:" name="op2" type="xsd:" name="result" type="xsd:" name="result" type="xsd:" Interface definiert ein (abstraktes) Interface enthält eine oder mehrere operations interface entspricht in Java dem Interface interface Calculator Calculator add( add( a, a, b); b); Definiert Eingabe und AusgabeMeldung wsdl:input = request "Messages" wsdl:output = response <xs:element name="request"> Name Name Interfaces Interfaces Namen der Operation(en) Namen der Operation(en) <xs:element name="request"> <xs:element name="response"> <xs:element name="response"> <xs:element <xs:element name="request"> name="request"> <xs:element <xs:element name="response"> name="response"> Namen Namen Meldungsteils Meldungsteils Typ Typ Meldungsteils Meldungsteils (part) (part) <wsdl:interface <wsdl:interface name="calculator"> name="calculator"> <wsdl:operation <wsdl:operation name="add" name="add" pattern=" pattern=" <wsdl:input <wsdl:input messagelabel="addrequestop" messagelabel="addrequestop" element="tns:request" element="tns:request" <wsdl:output <wsdl:output messagelabel="addresponseop" messagelabel="addresponseop" element="tns:response" element="tns:response" </wsdl:interface> </wsdl:interface> Meldungen für request und response Meldungen für request und response 47 von von 64

13 Protokoll binding binding: bindet Interface an Protokoll enthält eine oder mehrere operations entspricht Aufbau von Interface Interface <wsdl:interface name="calculator"> <wsdl:interface name="calculator"> <wsdl:operation name="add" > <wsdl:operation name="add" > <wsdl:input name="addrequestop" <wsdl:input name="addrequestop" <wsdl:output name="addresponseop" <wsdl:output name="addresponseop" </wsdl:interface> </wsdl:interface> <wsdl:binding <wsdl:binding name="calculatorsoapbinding" name="calculatorsoapbinding" type="impl:calculator"> type="impl:calculator"> Name <wsdlsoap:binding <wsdlsoap:binding style="rpc" Name style="rpc" Interfaces Interfaces Transport=" Transport=" <wsdl:operation <wsdl:operation name="add"> verwende name="add"> verwende <wsdl:input <wsdl:input name="addrequestop"> Name der Alle name="addrequestop"> Name der für für Transport Transport Alle Operation Operationen Operation Operationen </wsdl:input> </wsdl:input> <wsdl:output <wsdl:output name="addresponseop"> name="addresponseop"> Namen der Namen der Operationsteile Operationsteile </wsdl:output> </wsdl:output> </wsdl:binding> </wsdl:binding> konkretes Interface: EndPoint und definiert endpoint: protokollabhängiges, konkretes Interface mehrere EndPoints, für verschiedene Protokolle möglich wsdlsoap:address : AdressElement EndPoints location Attribut: URI EndPoints Namen Namen EndPoints EndPoints Namen Namen <wsdl:binding name="calculatorsoapbinding" > <wsdl:binding name="calculatorsoapbinding" > <wsdlsoap:binding <wsdlsoap:binding <wsdl:operation name="add"> <wsdl:operation name="add"> </wsdl:binding> </wsdl:binding> <wsdl:service <wsdl:service name="calculator"> name="calculator"> <wsdl:endpoint <wsdl:endpoint name="calculator" name="calculator" binding="impl:calculatorsoapbinding" binding="impl:calculatorsoapbinding" > > <wsdlsoap:address <wsdlsoap:address location=" location=" </wsdl:endpoint> </wsdl:endpoint> </wsdl:service> </wsdl:service> URL Web s URL Web s 49 von von 64 Steuerung Serialisierungsformats Fehler: Faults use: beschreibt auf welche grundsätzliche Art die Daten serialisiert werden sollen "literal" : übermittelte Daten im Body entsprechen (exakt) dem Schema. "encoded": übermittelte Daten im Body sind nach encodingstype Attribut definiertem Verfahren codiert (z.b. Section 5) encodingstyle: identifiziert Regel, wie serialisiert werden soll es können beliebige (eigene) Encodingformate definiert werdenn oft Section 5 Encoding " style: beschreibt den Stil (Struktur) Aufruf "rpc" erstes Kind Element von Body Element wird automatisch erzeugt ( Namen der Method); Daten werden als Kind Elemente übergeben "dokument" es wird nur ein Element beim Aufruf übergeben; diese Element enthält alle Daten add( add( a, a, b); b); class addrequestop class addrequestop a,b a,b add(addrequestop add(addrequestop msg); msg); Detaillierte Fehlermeldung kann definiert werden fault folgt dem body Element gleich wie input und output: message,interface, binding Wird eher selten gemacht StandardFehlerelement wird stattsen verwendet <wsdl:definitions <wsdl:definitions <wsdl:message name='overflow'> <wsdl:message name='overflow'> <wsdl:part name='overflowfault' element='xsd:string' <wsdl:part name='overflowfault' element='xsd:string' </wsdl:message> </wsdl:message> <wsdl:interface <wsdl:interface <wsdl:operation name='add'> <wsdl:operation name='add'> <wsdl:input message='wsdlns:dividerequest' <wsdl:input message='wsdlns:dividerequest' <wsdl:output message='wsdlns:divideresponse' <wsdl:output message='wsdlns:divideresponse' <wsdl:fault message='typens:overflow' name='overflow' <wsdl:fault message='typens:overflow' name='overflow' <wsdl:binding name='arithmeticssoapbinding' type='impl:arithmeticsendpoint' > <wsdl:binding name='arithmeticssoapbinding' type='impl:arithmeticsendpoint' > <soap:binding <soap:binding <wsdl:operation <wsdl:operation <soap:body <soap:body <wsdl:fault> <wsdl:fault> <wsdlsoap:fault name="overflow" <wsdlsoap:fault name="overflow" </wsdl:fault> </wsdl:fault> 51 von von 64

14 Aufrufe in Java Definition eines Java APIs for based RPC (JAX) Sun liefert ReferenzImplementation: Teil von J2EE Konkrete Implementation JSR181 JSR181 Config Config Client Client Generierte Generierte Stubs Stubs JAX JAX Runtime Runtime Import, Gen Server Server JAX JAX Runtime Runtime Web Web Server Server 53 von von 64 Erzeugen der Client Stub Klassen Klientenseitig : 1) Aufruf über generierten Stubs Der Web Server bietet unter der URL an Stubs müssen mittels KommandozeilenWerkzeug erzeugt werden directory directory Statische Bindung an Interface () Interface Implementation (endpoint) Aufruf einfach 1) Instanziere 2) hole EndPoint Interface 3) rufe EndPoint Interface bzw. die implementierende Klasse wsimport d. keep p com.javatutor.insel.ws.gen.chrisws Aus "Java ist auch eine Insel", Galileo Computing package der package der generierten generierten Klassen Klassen DII Client Client Generierte Generierte Stubs Stubs JAX JAX Runtime Runtime wsimport Calculator service = new Calculator(); Calculator service = new Calculator(); Calculator calc = service.getcalculatorendpoint(); Calculator calc = service.getcalculatorendpoint(); d = calc.add(4,5); d = calc.add(4,5); public interface Calculator public interface Calculator public Calculator getcalculator(); public Calculator getcalculator(); public class Calculator public class Calculator public Calculator getcalculatorendpoint() public Calculator getcalculatorendpoint() von von 64

15 Klientenseitig : 2) Aufruf über DII JAX mit (JSR181 Web Metadata) Dynamic Invocation Interface : DII Dynamischer Bindung an keine nötig Aufruf wird mittels generischen Klassen und Call "von Hand" aufgebaut Selber verantwortlich, dass Reihenfolge, Anzahl und Typen der Argumente korrekt nur für einfache Beispiele geeignet, fehleranfällig import org.apache.axis.client.call; 1)Instanziere den import org.apache.axis.client.call; 1)Instanziere den import org.apache.axis.client.; generischen import org.apache.axis.client.; generischen String endpoint = " String endpoint " String namespace = " String namespace = " service = new (); service = new (); Call call = (Call) service.createcall(); Call call = (Call) service.createcall(); call.settargetendpointaddress( new java.net.url(endpoint)); call.settargetendpointaddress( new java.net.url(endpoint)); call.setoperationname(new javax.xml.namespace.qname(namespace, "add")); call.setoperationname(new javax.xml.namespace.qname(namespace, "add")); Object param = new Object[2]; Object param = new Object[2]; param[0] = new Double(4); param[0] = new Double(4); param[1] = new Double(5); param[1] = new Double(5); Double ret = (Double) call.invoke(param); Double ret = (Double) call.invoke(param); 2)Erzeuge 2)Erzeuge generisches generisches Call Call Object Object 6)Führe 6)Führe Aufruf Aufruf aus aus 3)Setze Adresse 3)Setze Adresse s s 4)Setze Namen 4)Setze Namen der Operation der Operation 5)Konstruiere 5)Konstruiere Argumentliste: Object[] Argumentliste: Object[] 57 von 64 Seit Java 6 in JDK integriert Definition der Web Schnittstelle einer annotierten Java Klasse Folgende Annotation in javax.ws und javax.ws.soap Jede WebImplementierung muss diese KlassenAnnotation besitzen. Optionale Elemente sind zum Beispiel name (bestimmt den <wsdl:interface>, Standard ist der unqualifizierte Name der Klasse bzw. Schnittstelle), targetnamespace, servicename oder Setzt den Stil der Nachrichten auf Dokument oder Die Annotation macht eine Methode zur WebOperation. Der StandardName unter <wsdl:operation> ist der Name der Methode; er lässt sich mit dem Element operationname ändern. Beschreibt die Parameter genauer. Das Element name überschreibt den Parameternamen, der sonst»argx«heißen würde, für das Element Definiert die Rückgabe einer WebMethode Für asynchrone Aufrufe. Aus "Java ist auch eine Insel", Galileo Computing 58 von 64 Beispiel eines Servers Erzeugen der Server Klassen ist einfache Java Klasse (POJO) = Binding.Style.DOCUMENT, package com.javatutor.insel.ws; = Binding.Style.DOCUMENT, package com.javatutor.insel.ws; use=binding.use.literal,parameterstyle=binding.paramet use=binding.use.literal,parameterstyle=binding.paramet erstyle.bare) import javax.jws.*; erstyle.bare) import javax.jws.*; import javax.jws.soap.*; @Binding(style = = Binding.Style.RPC) public class MyBmiWeb public public String hello( String name ) public String hello( String name ) return "Hello " + name + "!"; return "Hello " + name @WebResult(name = = "yourbmi") public height, public weight weight ) bmi = weight / (height * height) * 10000; bmi = weight / (height * height) * 10000; System.out.println(this.getClass().getSimpleName()+" called:"+height+ " "+weight+" "+bmi); System.out.println(this.getClass().getSimpleName()+" called:"+height+ " "+weight+" "+bmi); return bmi; return bmi; Aus "Java ist auch eine Insel", Galileo Computing Die Timer Klasse enthält Implementation von Web Versehene mit JSR 181 Annotationen ressource ressource Files 1.2 Files 1.2 wsgen r. extension wsdl:xsoap1.2 cp. keep timerservice.timer Java Klasse Java Klasse Aus "Java ist auch eine Insel", Galileo Computing 59 von von 64

16 Veröffentlichung Webs Der Klient In JSDK 1.6 ist auch ein MiniWebServer integriert Der Klient muss generierte Klassen importieren Mittels Endpoint.publish wird der angemeldet package com.javatutor.insel.ws; package com.javatutor.insel.ws; package com.javatutor.insel.ws; package com.javatutor.insel.ws; import javax.swing.joptionpane; import javax.swing.joptionpane; import javax.xml.ws.endpoint; import javax.xml.ws.endpoint; public class PublishWsOnServer public class PublishWsOnServer public static void main( String[] args ) public static void main( String[] args ) String endpointurl = " String endpointurl = " Object service = new MyBmiWeb(); Object service = new MyBmiWeb(); Endpoint endpoint = Endpoint.publish(endpointUrl,service); Endpoint endpoint = Endpoint.publish(endpointUrl,service); JOptionPane.showMessageDialog( null, service.getclass().getsimplename() JOptionPane.showMessageDialog( null, service.getclass().getsimplename() +" started on "+ endpointurl+"\nstop?"); +" started on "+ endpointurl+"\nstop?"); endpoint.stop(); endpoint.stop(); import com.javatutor.insel.ws.gen.chrisws.bmiwebs; import com.javatutor.insel.ws.gen.chrisws.bmiwebs; import com.javatutor.insel.ws.gen.chrisws.mybmiweb; import com.javatutor.insel.ws.gen.chrisws.mybmiweb; public class MyBmiClient public class MyBmiClient public static void main( String[] args ) public static void main( String[] args ) BmiWebs EndPoint = new MyBmiWeb().getBmiWebsEndPoint(); BmiWebs EndPoint = new MyBmiWeb().getBmiWebsEndPoint(); System.out.printf( "%s Your BMI is %.1f%n", System.out.printf( "%s Your BMI is %.1f%n", EndPoint.hello( "Chris" ), EndPoint.hello( "Chris" ), EndPoint.bodyMassIndex( 183, 84 ) ); EndPoint.bodyMassIndex( 183, 84 ) ); Aus "Java ist auch eine Insel", Galileo Computing Aus "Java ist auch eine Insel", Galileo Computing 61 von von 64 Zusammenfassung Referenzen, Links Web bietet Funktionen mittels WebTechnologie an definiert Standardformat für Web s, basierend auf Daneben eine Reihe von Diensten: UDDI, Security, Transaction Meldung besteht aus Envelope, Header, Body (Fault) Meist wird für den Transport verwendet Zur Beschreibung verwendet man abstrakte Schnittstelle(Interface), Binding (EndPoint), Web Java APIs for based Communication: JAX Liste verfügbarer Web s: & Web s & Java home Java Web s tutorial Java Web s tutorial 1.1,1.2 Java ist auch eine Insel von Christian Ullenboom JAX als Teil JDK von von 64