Simple Object Access Protocol SOAP Simple Object Access Protocol

Apakah SOAP? Saat ini web adalah komunikasi antara manusia dan aplikasi. SOAP adalah komunikasi aplikasi ke aplikasi SOAP adalah lightweight protocol untuk pertukaran informasi yg terstruktur dalam lingkungan desentralisasi dan terdistribusi. SOAP menggunakan XML technologies dalam mendefinisikan framework messagingnya framework ini dirancang independen terhadap berbagai model programming

SOAP adalah communication protocol SOAP adalah a format untuk sending messages SOAP dirancang untuk komunikasi via Internet SOAP adalah platform independent SOAP adalah language independent SOAP adalah simple and extensible SOAP bisa melewati firewalls SOAP adalah W3C standard

SOAP Architecture Spesifikasi SOAP terdiri dari 4 bagian: SOAP envelope: menjelaskan format dari SOAP message. SOAP encoding: menggambarkan dari representasi data yang dikirim dalam sebuah pesan. SOAP RPC: mendefinisikan bagaimana SOAP message dapat mengeksekusi remote procedure calls (RPCs). SOAP binding framework: mendefinisikan protocol yang digunakan SOAP messages yang dikirim oleh aplikasi.

One way message

Request response

SOAP format SOAP message terdiri dari tiga bagian: SOAP Envelope SOAP Header (optional) SOAP Body

Contoh apache 4 3 1 2 5 Apache SOAP service: HelloService.java sayHello(“Yuhong”,”Yan) “Yuhong Yan, Welcome to SOAP…” 3 Apache SOAP client: HelloClient.java Apache SOAP rpcrouter servlet 1 SOAP request: Service name: urn:HelloWorld Method name: sayHello Parameter: firstName=“Yuhong” lastName=“Yan 2 Jakarta Tomcat server 5 SOAP response: Return value: “Yuhong Yan, welcome to SOAP” Http POST Http GET

SOAP Envelope SOAP Envelope mendefinisikan keseluruhan framework untuk menjawab apa yang didalam message dan siapa yang terlibat Envelope adalah top element dari XML document yang perepresentasikan message. Envelope element selalu menjadi root element dari SOAP message. Envelope element terdiri dari optional Header element Dan mandatory Body element.

SOAP Envelope Code <soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"> <soap:Header> <!-- optional --> <!-- header blocks go here... --> </soap:Header> <soap:Body> <!-- payload or Fault element goes here... --> </soap:Body> </soap:Envelope>

Envelope element penggunaan xmlns:soap namespace selalu menggunakan http://www.w3.org/2001/12/soap-envelope

EncodingStyle SOAP encodingStyle attribute digunakan untuk mendefinisikan type data yang digunakan dalam dokumen. attribute ini bisa muncul pada setiap SOAP element, dan berpengaruh hanya pada elemen tersebut dan childnya SOAP message tidak mempunyai default encoding.

SOAP Header Header element adalah generic container untuk informasi kontrol Bisa berupa beberapa elements dari beberapa namespace Header berisi informasi proses dari message Header adalah optional

SOAP Header <soap:Header> <!-- security credentials --> <s:credentials xmlns:s="urn:examples-org:security"> <username>dave</username> <password>evad</password> </s:credentials> </soap:Header>

Body Elemen body menjelaskan messagenya <soap:Body> <x:TransferFunds xmlns:x="urn:examples-org:banking"> <from>22-342439</from> <to>98-283843</to> <amount>100.00</amount> </x:TransferFunds> </soap:Body>

Contoh request SOAP Message Embedded in HTTP Request: <SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"   SOAPENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"> <SOAP-ENV:Body>        <m:GetLastTradePrice xmlns:m="Some-URI">            <symbol>DIS</symbol>        </m:GetLastTradePrice>    </SOAP-ENV:Body> </SOAP-ENV:Envelope>

Contoh response SOAP Message Embedded in HTTP Response: <SOAP-ENV:Envelope   xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"   SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"/>    <SOAP-ENV:Body>        <m:GetLastTradePriceResponse xmlns:m="Some-URI">            <Price>34.5</Price>        </m:GetLastTradePriceResponse>    </SOAP-ENV:Body> </SOAP-ENV:Envelope>

SOAP Security SOAP specification tidak mendefinisikan encryption untukk XML Web Services. Diserahkan kepada implementer dari SOAP protocol. Encryption tergantung dari transport protocol apakah transport protocol tersebut support secure communication? cost dari enkripsi semua data dibandingan dengan sebagian data?

Contoh <%@ WebService Language="C#" Class="CreditCardService" %> using System.Web.Services; public class CreditCardService { [WebMethod] [EncryptionExtension(Encrypt=EncryptMode.Response)] public string GetCreditCardNumber() { return "MC: 4111-1111-1111-1111"; }

Request yg dienkripsi <?xml version="1.0" encoding="utf-8"?> <soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema"> <soap:Body> <GetCreditCardNumber xmlns="http://tempuri.org/" /> </soap:Body> </soap:Envelope>

Response yg dienkripsi <soap:Body> <GetCreditCardNumber xmlns="http://tempuri.org/"> <GetCreditCardNumberResult>83 151 243 32 53 95 86 13 190 134 188 241 198 209 72 114 122 38 180 34 194 138 16 97 221 195 239 86 26 152 94 27 </GetCreditCardNumberResult> </GetCreditCardNumber> </soap:Body>

SOAP Fault Element Error mesage dari SOAP mesage dimasukkan kedalam Fault element. (optional) jika Fault element ada, maka harus muncul sebagai elemen child pada Body element. Fault element hanya muncul sekali dalam SOAP message.

SOAP Fault Element SOAP Fault element mempunyai sub elements: <faultcode > A code for identifying the fault <faultstring > A human readable explanation of the fault <faultactor > information about who caused the fault to happen URI value identifying the source <detail> error information related only to the Body element. if not present then indicates that the fault is not related to the Body element.

faultcode

Contoh

HTTP HTTP communicates over TCP/IP. An HTTP client connects to an HTTP server using TCP. After establishing a connection, the client can send an HTTP request message to the server: POST /item HTTP/1.1 Host: 189.123.345.239 Content-Type: text/plain Content-Length: 200

HTTP The server then processes the request and sends an HTTP response back to the client. The response contains a status code that indicates the status of the request:

SOAP HTTP Binding A SOAP method is an HTTP request/response that complies with the SOAP encoding rules. HTTP + XML = SOAP A SOAP request could be an HTTP POST or an HTTP GET request. POST -- Send GET -- Retrieve

SOAP request and response The Content-Type header for a SOAP request and response defines the MIME type for the message and the character encoding (optional) used for the XML body of the request or response.

SOAP request and response The Content-Length header for a SOAP request and response specifies the number of bytes in the body of the request or response.

Contoh GetStockPrice request is sent to a server. The request has a StockName parameter, and a Price parameter will be returned in the response. The namespace for the function is defined in http://www.example.org/stock address. The SOAP request: