Simple Object Access Protocol. Web Services Description Language

Size: px

Start display at page:

Download "Simple Object Access Protocol. Web Services Description Language"

Shanna Jennings
6 years ago
Views:

1 Simple Object Access Protocol Web Services Description Language ***"#$%& '() "!

2 ... INTRODUCTION.. SIMPLE OBJECT ACCESS PROTOCOL...Why SOAPSOAP...SOAP Building BlocksSOAP...Syntax Rules...Optional SOAP Header Eelement!SOAP...Actor Element Actor... mustunderstand Element mustunderstand... encodingstyle Element encodingstyle...the SOAP Body ElementSOAP "... The HTTP ProtocolHTTP...SOAP HTTP BindingHTTP #SOAP WEB SERVICES DESCRIPTION LANGUAGEWSDL$ % & ' What is WSDLWSDL '()... WSDL DocumentWSDL...WSDL Document Structure WSDL... WSDL Ports WSDL... WSDL Messages WSDL... WSDL Types WSDL...WSDL Binding WSDL...WSDL PortsWSDL * 2

3 ...WSDL BindingWSDL...WSDL WSDL 3

4 Introduction! " #$% &, - &. /0 '()* +$+(! B2C Business to consumer%$12 )1) 3145! %$121 $545!21/#$ $1 9:/%3":" 14%%$3)/8%& $%/7 1*4=5 ; < 3)+/* 14 >* Simple Object Access Protocol &1 $ < 1&)%6 *)% % A 4' $9HTTP$ 6.BPlatform W3CC3/!9BD )>1/? ' EWhy SOAP SOAP4 #? % RPC +&=94 % '4+/ RPC B6 )%4 F HTTP$%$BDCOM, CORBA 9#<&? $ )%G1$")% <%H 37 BHTTP$< 9 % A I G J9(),SOAP$:"*4!B ' I &$%4/ >1/& % A %K9HTTP$< ' 2 B1@"C SOAP Building Blocks SOAP$:.1 &%I XML? 1%/+/ 9SOAP$ SOAP $XML? 1? &D 1Envelope? 1@ / 4

5 1&D D D / ),:/' 1&D D Body %$ / )&:## :G 1&%KD D ; / Skeleton SOAP Message <?xml version="1.0"?> <soap:envelope Syntax Rules $/! XML4"%)SOAP Enveloped1@%$%)SOAP Encoded+(%$%)SOAP XML)& 1&D '%)SOAP xmlns:soap=" soap:encodingstyle=" <soap:header> </soap:header> <soap:body> <soap:fault> 5

6 </soap:fault> </soap:body> </soap:envelope> &)D 9SOAPF G &9SOAP? 1@ /%* $3&7 XML? 1(D 9M4A $SOAPXMLL? xmlns:soap<%/6 4SOAP xmlns:soap=" NameSpace)37 SOAP? 1@3;? 1@!%$J2 >@1;<? 1NameSpace483 Optional SOAP Header ' SOAP$ / 42SOAP%/+ 1&D D /9 / Eelement PAYMENT 5 1/%/ 1&G+2"%G# < NTransN &>1/Header 3D >1/G #%* BNN NmustUnderstandN I 'namespace 7 A#SOAP? & 9 J9Nhttp:// actor mustunderstand encodingstyle '1/4? $ 1 6

7 Actor Element Actor +&3!<+/>*%soap%* 2 9 J92%86 Syntax soap:actor="uri" Example <soap:header> <m:trans xmlns:m=" soap:actor=" 234 </m:trans> </soap:header> mustunderstand Element mustunderstand '42)&%>1/)* J94 D 4D )*9M>& D 2 $* D )*2 $* 7

8 Syntax soap:mustunderstand="0 1" Example soap:header> <m:trans xmlns:m=" soap:mustunderstand="1"> 234 </m:trans> </soap:header> encodingstyle Element encodingstyle J9? 1 4 &4encodingStyle $ & &6 &H 9SOAP /D 52C! OI 3 Syntax soap:encodingstyle="uri" Example <?xml version="1.0"?> <soap:envelope xmlns:soap=" soap:encodingstyle=" 8

9 ... Message information goes here... </soap:envelope> 1&soapD D 9Body soap4) / The SOAP Body Element SOAP $4) / <soap:body> <m:getprice xmlns:m=" <m:item>apples</m:item> </m:getprice> </soap:body> Bsoap /%F 9Getprice<%/BP& 1<# &1Item<%/4#%Prices&G ' 1$)'%$P <soap:body> <m:getpriceresponse xmlns:m=" <m:price>1.90</m:price> </m:getpriceresponse> </soap:body> 9

10 The HTTP Protocol HTTP $ %G6 TCP/IP$<& '$%HTTP$& &## 2TCP/IP$ B &$9 45 Q TCP$4HTTP$ISO? % POST /item HTTP/1.1 Host: Content-Type: text/plain Content-Length: 200 $">1/4>*HTTP 1%(7 BTTP 200 OK %(>*HTTP)' 1=&4R/ Content-Type: text/plain Content-Length: 200,1/P)9B9a status code&4<# +&%$J9S&? 1424*4%7 ' 400 Bad Request Content-Length: 0 $"%! SOAP HTTP Binding HTTP $5SOAP$ 12HTTP)1/ 11/%/+/Soap4&T2%*. XML5< Soap%5I HTTP + XML = SOAP 10

11 HTTP POST request HTTP GET request %/%9Soap 1%1/ Content-Type and Content-Length9HTTP% ) Content-Length: bytes Example POST /item HTTP/1.1 Content-Type: application/soap+xml; charset=utf-8 Content-Length: 250 4Content-Length<%/4Content-Type<%/7 The SOAP request POST /InStock HTTP/1.1 Host: Content-Type: application/soap+xml; charset=utf-8 Content-Length: nnn soap4) / <?xml version="1.0"?> <soap:envelope xmlns:soap=" soap:encodingstyle=" <soap:body xmlns:m=" <m:getstockprice> <m:stockname>ibm</m:stockname> </m:getstockprice> </soap:body> </soap:envelope> 4/# 11

12 A SOAP response HTTP/ OK Content-Type: application/soap; charset=utf-8 Content-Length: nnn <?xml version="1.0"?> <soap:envelope xmlns:soap=" soap:encodingstyle=" <soap:body xmlns:m=" <m:getstockpriceresponse> <m:price>34.5</m:price> </m:getstockpriceresponse> </soap:body> </soap:envelope> 12

13 Web Services Description Language WSDL (Web Services Description 2 '? XML(>1/@%/+/ 2&& WSDL@ 9 WSDL@1 $:()G%/7 WSDL WSDL port interfacedwsdl@12)7wsdl D WSDL@1 2)%/7 WSDL WSDL binding interface <# :)$WSDL@11$/- &WSDL@/! W3C What is WSDL 9 +/WSDL (Web Services Description & 2 '? XML(>1/@%/ XML@1GV >1/&1%$%6 1/WSDL@!2& SchemaNamespaces /I 29 (+/2? 4 XMLL$ XML%/+/ &&. 4W3C!%# $%/+/ 9? &S@ 9WSDL@%** 5!A#4%;$? 947 XML@1 J9 1/< >G!7 W3C%I WSDL@1 >1/? & Ariba, IBM and $"!%W3C+$$@1J9%WSDL

14 7 M ) XML'$>1/&? Microsoft U 1 5)121&)W3CK4 $%/+/ 9W3C $% 'W3C $"&7 K $"+/!%92 K<2K!% $!%$%+I & WSDL 1.2 Q Draft&SW> 2/"$2I / ( W3C!% WSDL Document WSDL XML$ $9WSDL%6 $$? &? &%/)>1/D WSDL Document Structure WSDL & 4 WSDL? &? L 4 1&? &4 Element & <porttype> Lmessages 9? &4 <message>!% data types L&L? &4 <types>!% L ' '$? & 4 <binding>!% 14

15 >1/WSDL <definitions> <types> definition of types... </types> <message> definition of a message... </message> <porttype> definition of a port... </porttype> <binding> definition of a binding... </binding> </definitions> extension & /#X /I D %WSDL%$ %I &+& &+/5) /A#elements /!+A %WSDL@11$/>1/HA,6 $ BWSDL WSDL WSDL Ports WSDL 94 BWSDL%I &49%ZportTypeY& 2%$ B9%$ 1&B? & & 15

16 +? $#$ZportTypeY &&%%$ 1 WSDL Messages WSDL!%messages? & ZmessageY &4 :()%? ;%%$ 1& & /? &47 5 $:()3"6 $ B#$ WSDL Types WSDL!%data types &? & ZtypesY &4 /!F WSDL@4X &? &XML Schema WSDL Binding WSDL!% ''$? & ZbindingY &4.2.2 $)%6 4@? &4$ <part name="value" type="xs:string"/> </message> <porttype name="glossaryterms"> <operation name="getterm"> <input message="gettermrequest"/> <output message="gettermresponse"/> </operation> </porttype> # WSDL%:().I # 1 16

17 ? &$14$NglossaryTermsN? &porttype &4<# 2 NgetTermN1&? &4$BNgetTermN43I 1/ /? &NgetTermResponseN4'TNgetTermRequestN4' &$:()message 3$%I 5 NgetTermN$$glossaryTerms&1 NgetTermRequestN9TNgetTermRequestN9 WSDL Ports WSDL!%2/4 1& 2)? WSDL4 9WSDL@ /#$9ZportTypeY &%8$$B 9()*%$ 1&? & &947 )@ +? $32"6 $? & 1)@%I 53I 1/$3"%$$$1 6 5%$/"#$GHrequest-response)[ 1H& &G'WSDL@? &? & L1&1%$ J) )&%%$ 1&1%$ )[ 1 )&? L*L1&1%$ )\:) )'C'44#% 1? L*1&1%$ &"* H One-way Request-response Solicit-response Notification )'C'4% 17

18 One-WayJ)H%1/ J) 1/>1/# 1 <message name="newtermvalues"> <part name="term" type="xs:string"/> <part name="value" type="xs:string"/> </message> <porttype name="glossaryterms"> <operation name="setterm"> <input name="newterm" message="newtermvalues"/> </operation> </porttype > NsetTermN>/J)1/? & NglossaryTermsN4<# NnewTermValuesN4F 1+) 1 81&J9. 1&J2TD? &4'NvalueNNtermN 9 ;D Request-Response)] 11/ 1&%H9%/# 1 )\ 1H%1/? & NglossaryTermsN4#9 7 ) 1&J )81&J94 BNgetTermN 9 T&? NtermN2 NgetTermRequestN>/ NvalueN>/5NgetTermResponseN 18

19 <message name="gettermrequest"> <part name="term" type="xs:string"/> </message> <message name="gettermresponse"> <part name="value" type="xs:string"/> </message> <porttype name="glossaryterms"> <operation name="getterm"> <input message="gettermrequest"/> <output message="gettermresponse"/> </operation> </porttype> WSDL Binding WSDL!% ''$? & ZBindingY &4$$ $)%6 &4$ <message name="gettermrequest"> <part name="term" type="xs:string"/> </message> <message name="gettermresponse"> <part name="value" type="xs:string"/> </message> <porttype name="glossaryterms"> <operation name="getterm"> <input message="gettermrequest"/> <output message="gettermresponse"/> )\ 11/D D #; 19

20 </operation> </porttype> <binding type="glossaryterms" name="b1"> <soap:binding style="document" transport=" /> <operation> <soap:operation soapaction=" <input> <soap:body use="literal"/> </input> <output> <soap:body use="literal"/> </output> </operation> </binding>? & typeh Bname4' 9% binding &6 1 JD 4'46 $&1/4name4' 6 1 NglossaryTermsN &1& 1"typeH transport Bstyle4 I % soap:binding & NdocumentN$"% NrpcN$"%style4 %$%%$? &4HTTP Bdocument+G4 1 &4 HTTP94$ SOAP54$ 20

21 SOAP7? &41/$)%2I &1/$? &operation NliteralN T($I %)< WSDL WSDL 3 4$WSDL Syntax Q 1$/ 1 W3C%/+ Draft <wsdl:definitions name="nmtoken"? targetnamespace="uri"> <import namespace="uri" location="uri"/> * <wsdl:types>? <xsd:schema... /> * </wsdl:types> <wsdl:message name="ncname"> * <part name="ncname" element="qname"? type="qname"?/> * </wsdl:message> <wsdl:porttype name="ncname"> * <wsdl:operation name="ncname"> * <wsdl:input message="qname">? 21

22 </wsdl:input> <wsdl:output message="qname">? </wsdl:output> <wsdl:fault name="ncname" message="qname"> * </wsdl:fault> </wsdl:operation> </wsdl:porttype> <wsdl:servicetype name="ncname"> * <wsdl:porttype name="qname"/> + </wsdl:servicetype> <wsdl:binding name="ncname" type="qname"> * <-- binding details --> * <wsdl:operation name="ncname"> * <-- binding details --> * <wsdl:input>? 22

23 <-- binding details --> </wsdl:input> <wsdl:output>? <-- binding details --> * </wsdl:output> <wsdl:fault name="ncname"> * <-- binding details --> * </wsdl:fault> </wsdl:operation> </wsdl:binding> <wsdl:service name="ncname" servicetype="qname"> * <wsdl:port name="ncname" binding="qname"> * <-- address details --> </wsdl:port> </wsdl:service> </wsdl:definitions> 23

SOAP Introduction. SOAP is a simple XML-based protocol to let applications exchange information over HTTP.

SOAP Introduction. SOAP is a simple XML-based protocol to let applications exchange information over HTTP. SOAP Introduction SOAP is a simple XML-based protocol to let applications exchange information over HTTP. Or more simply: SOAP is a protocol for accessing a Web Service. What You Should Already Know Before