The Simple Object Access Protocol

1
The Simple Object Access Protocol

2
Sources of Information

• SOAP Tutorial, http//www.w3schools.com/soap/defau
  lt.asp
• SoapRPC.com Tutorials, (http//www.soaprpc.com/tu
  torials/) A Busy Developers Guide To Soap1.1
• DaveNet XML-RPC for Newbies, http//davenet.user
  land.com/1998/07/14/xmlRpcForNewbies

3
Introduction

• SOAP is a Remote Procedure Calling protocol
  that works over HTTP.
• The body of the request is in XML. A procedure
  executes on the server and the value it returns
  is also formatted in XML.
• Procedure parameters and returned values can be
  scalars, numbers, strings, dates, etc. and can
  also be complex record and list structures.(-
  A Busy Developers Guide To Soap1.1)

4
Remote Procedure Call using HTTP
5
Example  of a SOAP request

• POST /examples HTTP/1.1User-Agent
  Radio UserLand/7.0 (WinNT)Host
  localhost81Content-Type text/xml
  charsetutf-8Content-length 474SOAPAction
  "/examples"lt?xml version"1.0"?gtltSOAP-ENVEnvel
  ope SOAP-ENVencodingStyle
• "http//schemas.xmlsoap.org/soap/encoding/"
  xmlns
• SOAP-ENC"http//schemas.xmlsoap.org/soap/enc
  oding/" xmlns
• SOAP-ENV"http//schemas.xmlsoap.org/soap/env
  elope/" xmlnsxsd"http//www.w3.org/1999/XMLSchem
  a" xmlnsxsi"http//www.w3.org/1999/XMLSchema-ins
  tance"gtltSOAP-ENVBodygt       ltmgetStateName
  xmlnsm"http//www.soapware.org/"gt         ltstat
  enum xsitype"xsdint"gt41lt/statenumgt         lt/m
  getStateNamegt lt/SOAP-ENVBodygt lt/SOAP-ENVEnvel
  opegt

6
An Example SOAP Request
7
Response example 

• HTTP/1.1 200 OKConnection
  closeContent-Length 499Content-Type text/xml
  charsetutf-8Date Wed, 28 Mar 2001 050504
  GMTServer UserLand Frontier/7.0-WinNTlt?xml
  version"1.0"?gtltSOAP-ENVEnvelope
  SOAP-ENVencodingStyle"http//schemas.xmlsoap.org
  /soap/encoding/" xmlnsSOAP-ENC"http//schemas.xm
  lsoap.org/soap/encoding/" xmlnsSOAP-ENV"http//s
  chemas.xmlsoap.org/soap/envelope/"
  xmlnsxsd"http//www.w3.org/1999/XMLSchema"
  xmlnsxsi"http//www.w3.org/1999/XMLSchema-instan
  ce"gt   ltSOAP-ENVBodygt      ltmgetStateNameRespo
  nse xmlnsm"http//www.soapware.org/"gt         lt
  Result xsitype"xsdstring"gtSouth
  Dakotalt/Resultgt         lt/mgetStateNameResponsegt
        lt/SOAP-ENVBodygt   lt/SOAP-ENVEnvelopegt

8
Response example 
9
Error Example

• HTTP/1.1 500 Server ErrorConnection
  closeContent-Length 511Content-Type text/xml
  charsetutf-8Date Wed, 28 Mar 2001 050632
  GMTServer UserLand Frontier/7.0-WinNTlt?xml
  version"1.0"?gtltSOAP-ENVEnvelope
  SOAP-ENVencodingStyle"http//schemas.xmlsoap.org
  /soap/encoding/" xmlnsSOAP-ENV"http//schemas.xm
  lsoap.org/soap/envelope/" xmlnsxsd"http//www.w3
  .org/1999/XMLSchema" xmlnsxsi"http//www.w3.org/
  1999/XMLSchema-instance"gt   ltSOAP-ENVBodygt     
   ltSOAP-ENVFaultgt         ltfaultcodegtSOAP-ENVCli
  entlt/faultcodegt         ltfaultstringgtCan't call
  getStateName because there are too many
  parameters.lt/faultstringgt         lt/SOAP-ENVFaul
  tgt      lt/SOAP-ENVBodygt   lt/SOAP-ENVEnvelopegt
  

10
Error Example