SOAP og Web Services. Hva er SOAP?

Transkript

1 SOAP og Web Services Tore Engvig Petter Vangstein Øyvind M. Wergeland Hva er SOAP? SOAP er en XML basert protokoll for meldinger og RPC. SOAP definerer kun overføringsformatet (analogt med GIOP i CORBA verden). SOAP baserer seg på en rekke XMLstandarder, og er selv en W3C standard. SOAP Simple Object Access Protocol (i versjon 1.1), men omhandler tjenester, ikke objekter. 1

2 Simple Object Access Protocol Service Oriented Hva er Web Services? Mye brukt definisjon: En tjeneste på web som tar XML som input og gir XML som output. Definisjon fra W3C (Web Services Architecture Requirements): [Definition: A Web service is a software application identified by a URI, whose interfaces and bindings are capable of being defined, described, and discovered as XML artifacts. A Web service supports direct interactions with other software agents using XML based messages exchanged via internet-based protocols.] 2

3 Historikk SOAP ble utviklet av Microsoft, Userland og DevelopMentor i som et enkelt alternativ til eksisterende RPC systemer. Dissens under utviklingen XML-RPC blir lansert som en selvstendig lettvekts skal bare RPC-protokoll. SOAP 1.1 blir en W3C standard (ihvertfall en Note) Interaksjonsmodell Klient REQUEST Tjener Asynkrone meldinger Klient REQUEST RESPONSE Tjener Synkrone meldinger Klient REQ RES Proxy REQ RES Tjener Proxyer kan kjedes, og har lov til å prosessere deler av meldinger 3

4 Web Service arkitektur UDDI 2. Register WSDL 3. Search 1. Create Web Client 4. SOAP Web Service XML & XSD veldig kort fortalt XML organiserer data i en struktur. XML Schema beskriver et XML dokuments struktur og betingelser. 4

5 SOAP-protokollen En SOAP-melding er et XML-dokument som består av en obligatorisk SOAPenvelope. En envelope består av en valgfri SOAPheader og en obligatorisk SOAP-body. <soap:envelope> Uttrykker Hva meldingen inneholder. Hvem som bør behandle den. Om meldingen er valgfri eller obligatorisk 5

6 Inneholder: <soap:envelope> Kan inneholde et encodingstyle attributt som beskriver reglene for deserialization av meldingen. Importere ønskede namespace. Må assosieres med namespacet " (versjonering) <soap:header> Kan brukes for å håndtere utvidelser av meldinger. For eksempel transaksjonshåndtering, brukerverifisering, betaling. 6

7 <soap:body> Er en beholder for obligatorisk informasjon tilsiktet den endelige mottakeren av meldingen. Typisk bruk er for å sette opp RPC og feilrapportering. SOAP definerer kun et element for bodyelementet; fault som brukes for rapportere feil. Enkle datatyper SOAP slutter seg til XML Schema s innebygde datatyper. For eksempel: int string float 7

8 WSDL (Web Services Description Language) WSDL er et XML dokument. WSDL beskriver WebServices. WSDL brukes også for å lokalisere WebServices. WSDL 1.1 er også en W3C Note WSDL-elementer Et WSDL dokument har følgende struktur: <definitions> <types> Type definisjoner (definert i et typesystem som f.eks. XSD) </types> <message> Beskriver data. </message> <porttype> Samling av metoder </porttype> <binding> Spesifiserer protokoll og dataformat for en porttype. </binding> </definitions> 8

9 SOAP vs. CORBA Tjenester beskrevet i IDL: - NamingService - TradingService - TransactionService - NotificationService -etc... Tjeneste beskrevet i WSDL: - UDDI (Trading/Naming/Interface Repository) ORB IIOP GIOP IOP CDR SOAP + HTTP SOAP XML SOAP vs. CORBA SOAP har ingen måter å representere objektreferanser. SOAP har ikke en objektmodell. SOAP har ikke innebygd støtte for å identifisere meldinger og hvilken melding et svar responderer til. SOAP spesifiserer ikke språkbindinger eller API-er. SOAP kan være veldig enkelt, eller ufyselig komplisert. SOAP er veldig utvidbart. Man står fritt til å velge datarepresentasjon i SOAP. 9

10 Språkbindinger for SOAP Ingen standardiserte språkbindinger. JAX-RPC implementert i bla Apache Axis er de facto standardbinding for Java..Net definerer sin egen binding og MS har en egen SOAP pakke (SOAP Toolkit 3.0). I Perl er SOAP-Lite standard. Quoter eksempel - IDL CORBA IDL for enkel stockquote: module StockQuote { exception StockQuoteFault { string message; }; interface SimpleStockQuote { double getstockquote(in string tickercode) raises (StockQuoteFault); }; }; 10

11 WSDL for enkel stockquote: Quoter eksempel - WSDL (1/5) <?xml version="1.0"?> <definitions name="simplestockquote" targetnamespace=" xmlns=" xmlns:soap=" xmlns:xsd=" xmlns:soap-enc=" xmlns:tns=" xmlns:s=" xmlns:wsdl=" <message name="getstockquoterequest"> <part name="tickercode" type="xsd:string"/> </message> Quoter eksempel - WSDL (2/5) <message name="getstockquoteresponse"> <part name="lasttradedvalue" type="xsd:double"/> </message> <message name="getstockquotefault"> <part name="faultmessage" type="xsd:string"/> </message> <porttype name="simplestockquoteporttype"> <operation name="getstockquote" parameterorder="tickercode"> <input message="tns:getstockquoterequest"/> <output message="tns:getstockquoteresponse"/> <fault message="tns:getstockquotefault"/> </operation> </porttype> 11

12 Quoter eksempel - WSDL (3/5) <binding name="simplestockquotesoapbinding" type="tns:simplestockquoteporttype"> <soap:binding style="rpc" transport=" <operation name="getstockquote"> <soap:operation soapaction=" <input> <soap:body use="encoded" namespace=" encodingstyle=" </input> <output> <soap:body use="encoded" namespace=" encodingstyle=" </output> Quoter eksempel - WSDL (4/5) <fault> <soap:body use="encoded" namespace=" encodingstyle=" </fault> </operation> </binding> 12

13 Quoter eksempel - WSDL (5/5) <service name="simplestockquoteservice"> <port binding="tns:simplestockquotesoapbinding" name="quoter"> <soap:address location=" </port> </service> </definitions> Quoter eksempel - request (1/2) POST /axis/services/quoter HTTP/1.0 Content-Type: text/xml; charset=utf-8 Accept: application/soap+xml, application/dime, multipart/related, text/* User-Agent: Axis/1.0 Host: localhost Cache-Control: no-cache Pragma: no-cache SOAPAction: Content-Length:

14 Quoter eksempel - request (2/2) <?xml version="1.0" encoding="utf-8"?> <soapenv:envelope xmlns:soapenv=" xmlns:xsd=" xmlns:xsi=" <soapenv:body> <ns1:getstockquote soapenv:encodingstyle=" xmlns:ns1=" <tickercode xsi:type="xsd:string">nhy</tickercode> </ns1:getstockquote> </soapenv:body> </soapenv:envelope> Quoter eksempel - response HTTP/ OK Content-Type: text/xml; charset=utf-8 Set-Cookie: 7 Set-Cookie2: 7 <?xml version="1.0" encoding="utf-8"?> <soapenv:envelope xmlns:soapenv=" xmlns:xsd=" xmlns:xsi=" <soapenv:body> <ns1:getstockquoteresponse soapenv:encodingstyle=" xmlns:ns1=" <lasttradedvalue xsi:type="xsd:double">123.0</lasttradedvalue> </ns1:getstockquoteresponse> </soapenv:body> </soapenv:envelope> 14

15 Quoter2 eksempel - IDL CORBA IDL for mer avansert stockquote: module StockQuote { exception StockQuoteFault { string message; }; typedef sequence <string> fields; struct FieldValue { string fieldname; double fieldvalue; }; typedef sequence <FieldValue> FieldValueSeq; interface ComplexStockQuote { FieldValueSeq getstockquote(in string tickercode, in fields fieldnames) raises (StockQuoteFault); }; }; WSDL for mer avansert stockquote: Quoter2 - WSDL (1/2) <types> <schema xmlns=" targetnamespace=" <import namespace = " <complextype name="arrayofstring"> <complexcontent> <restriction base="soap-enc:array"> <attribute ref="soap-enc:arraytype" wsdl:arraytype="string[]"/> </restriction> </complexcontent> </complextype> <complextype name="fieldvalue"> <attribute name="fieldname" type="string" use="required"/> <attribute name="fieldvalue" type="double" use="required"/> </complextype> 15

16 Quoter2 - WSDL (2/2) <complextype name="arrayoffieldvalue"> <complexcontent> <restriction base="soap-enc:array"> <attribute ref="soap-enc:arraytype" wsdl:arraytype="s:fieldvalue"/> </restriction> </complexcontent> </complextype> </schema> </types> Quoter2 - request (Axis) (1/2) [HTTP header] SOAPAction: " <?xml version="1.0" encoding="utf-8"?> <soapenv:envelope xmlns:soapenv=" xmlns:xsd=" xmlns:xsi=" <soapenv:body> <ns1:getstockquote soapenv:encodingstyle=" xmlns:ns1=" <tickercode xsi:type="xsd:string">nhy</tickercode> <fields xsi:type="soapenc:array soapenc:arraytype="xsd:string[3] xmlns:ns2=" xmlns:soapenc=" 16

17 <item>last</item> <item>high</item> <item>low</item> </fields> </ns1:getstockquote> </soapenv:body> </soapenv:envelope> Quoter2 - request (Axis) (2/2) [HTTP Header] Quoter2 - request (.Net) (1/2) <?xml version="1.0" encoding="utf-8"?> <soap:envelope xmlns:soap=" xmlns:soapenc=" xmlns:tns=" xmlns:types=" xmlns:xsi=" xmlns:xsd=" <soap:body soap:encodingstyle=" <tns:getstockquote> <tickercode xsi:type="xsd:string">nhy</tickercode> <fields href="#id1" /> </tns:getstockquote> 17

18 Quoter2 - request (.Net) (2/2) <soapenc:array id="id1" soapenc:arraytype="xsd:string[3]"> <Item>LAST</Item> <Item>HIGH</Item> <Item>LOW</Item> </soapenc:array> </soap:body> </soap:envelope> Interoperabilitet Har vært veldig dårlig, men er i rask bedring SOAP Builders interoperability lab definerer testmiljø for kompatibilitet Axis 1.0 og.net snakker nogenlunde brukbart sammen 18

19 Sikkerhet Ligger utenfor SOAP-spesifikasjonen I praksis, bruk HTTP/SSL (HTTPS) SOAP Security Extentions: Digital Signatures SOAP with attachments Bruker MIME til binære vedlegg. I praksis brukes oftest Base64-kodete elementer i SOAP body 19

20 Transaksjonshåndtering To standarder er under spesifisering: Web Service-Transactions (WS-T) er et sammarbeid mellom BEA, IBM og Microsoft. Business Transaction Protocol (BTP) er et samarbeid mellom BEA, Sun, Oracle, HP ++. (Samlet under OASIS) Status på videre utvikling W3C Web Service Activity: Web Service Architecture WG Architecture document editor s copy that has no official standing XML Protocol WG SOAP 1.2 Working Draft Web Service Description WG WSDL 1.2 Working Draft 20

21 Referanser SOAP 1.1: WSDL 1.1: W3C Web Services Activity: UDDI: Lessons learned from the Component Wars: An XML Manifesto, Don Box, DevelopMentor, September 99 Apache Axis Axis veldig gode SOAP linker 21