Võrgurakenduste protokollid 2

xml-rpc

Read: http://www.xmlrpc.com/

Call example:

POST /RPC2 HTTP/1.0
User-Agent: Frontier/5.1.2 (WinNT)
Host: betty.userland.com
Content-Type: text/xml
Content-length: 181

<?xml version="1.0"?> 
 <methodCall> 
       <methodName>examples.getStateName</methodName> 
       <params> 
           <param> <value><i4>41</i4></value> </param> 
      </params> 
  </methodCall> 

SOAP

Read in this order:

• wikipedia
• w3schools micro-tutorial
• w3c primer

Small recent example from xTee:

Request:

<soapenv:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xtee="http://x-tee.riik.ee/xsd/xtee.xsd" xmlns:ehis="http://producers.ehis.xtee.riik.ee/producer/ehis">
   <soapenv:Header>
      <xtee:id xsi:type="xsd:string">680e0c731a244e2c91210e1540458441</xtee:id>
      <xtee:nimi xsi:type="xsd:string">ehis.idpilet</xtee:nimi>
      <xtee:isikukood xsi:type="xsd:string">10101010101</xtee:isikukood>
      <xtee:andmekogu xsi:type="xsd:string">ehis</xtee:andmekogu>
      <xtee:asutus xsi:type="xsd:string">10747013</xtee:asutus>
   </soapenv:Header>
   <soapenv:Body>
      <ehis:idpilet soapenv:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
         <keha xsi:type="ehis:EHIS_Isikukood">10101010101</keha>
      </ehis:idpilet>
   </soapenv:Body>
</soapenv:Envelope>

Answer:

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
   <soapenv:Body>
      <ns1:idpiletResponse soapenv:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" xmlns:ns1="http://producers.ehis.xtee.riik.ee/producer/ehis">
         <paring xsi:type="ns1:EHIS_Isikukood">10101010101</paring>
         <keha xsi:type="ns1:EHIS_Boolean">ei</keha>
      </ns1:idpiletResponse>
   </soapenv:Body>
</soapenv:Envelope>

XML Schema

Read in this order:

• wikipedia
• w3schools micro-tutorial
• w3c primer

SOAP further explanations

Good explanatory stuff from simpler to more complex:

• http://www.eherenow.com/soapfight.htm
• http://www.ibm.com/developerworks/webservices/library/ws-whichwsdl/
• http://nmwg.internet2.edu/meetings/ggf10/dan-rpc-doc.ppt

SOAP extra tech

Stuff often used with SOAP: describing services (wsdl), service catalogue (uddi), additional interoperability standards (WS-I).

If worried, read "s stands for simple" first.

A detailed demo of SOAP and WSDL stuff with all the tiniest details can be found at the gsoap toolkit site. The demo WSDL used in the live examples is also quite readable.

WSDL

A detailed but partly almost readable w3c primer: http://www.w3.org/TR/wsdl20-primer/. You may also have a look at the old version primer.

A fairly good presentation explaining WSDL: Fail:WSDL.pdf

UDDI

Read the wikipedia overview

WS-I stuff

Read the wikipedia overview and have a brief look at the ws-i official site.