SOAP-トランスポート
SOAPはどのトランスポートプロトコルにも結び付けられていません。SOAPは、SMTP、FTP、IBMのMQSeries、またはMicrosoft Message Queuing(MSMQ)を介して転送できます。
SOAP仕様には、HTTPに関する詳細のみが含まれています。HTTPは依然として最も人気のあるSOAPトランスポートプロトコルです。
HTTP経由のSOAP
非常に論理的には、SOAP要求はHTTP要求を介して送信され、SOAP応答はHTTP応答のコンテンツ内で返されます。SOAPリクエストはHTTPGETを介して送信できますが、仕様にはHTTPPOSTの詳細のみが含まれています。
さらに、コンテンツタイプをtext / xmlに設定するには、HTTPリクエストとレスポンスの両方が必要です。
SOAP仕様では、クライアントがSOAPActionヘッダーを提供する必要がありますが、SOAPActionヘッダーの実際の値は、SOAPサーバーの実装によって異なります。
たとえば、XMethodsによってホストされているAltaVista BabelFish Translationサービスにアクセスするには、SOAPActionヘッダーとして以下を指定する必要があります。
urn:xmethodsBabelFish#BabelFish
サーバーが完全なSOAPActionヘッダーを必要としない場合でも、クライアントは空の文字列( "")またはnull値を指定する必要があります。例-
SOAPAction: ""
SOAPAction:
これは、HTTP経由でXMethods BabelfishTranslationサービスに送信されるサンプルリクエストです。
POST /perl/soaplite.cgi HTTP/1.0
Host: services.xmethods.com
Content-Type: text/xml; charset = utf-8
Content-Length: 538
SOAPAction: "urn:xmethodsBabelFish#BabelFish"
<?xml version = '1.0' encoding = 'UTF-8'?>
<SOAP-ENV:Envelope
xmlns:SOAP-ENV = "http://schemas.xmlsoap.org/soap/envelope/"
xmlns:xsi = "http://www.w3.org/1999/XMLSchema-instance"
xmlns:xsd = "http://www.w3.org/1999/XMLSchema">
<SOAP-ENV:Body>
<ns1:BabelFish
xmlns:ns1 = "urn:xmethodsBabelFish"
SOAP-ENV:encodingStyle = "http://schemas.xmlsoap.org/soap/encoding/">
<translationmode xsi:type = "xsd:string">en_fr</translationmode>
<sourcedata xsi:type = "xsd:string">Hello, world!</sourcedata>
</ns1:BabelFish>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
コンテンツタイプとSOAPActionヘッダーに注意してください。BabelFishメソッドには2つのStringパラメーターが必要であることに注意してください。翻訳モードen_frは、英語からフランス語に翻訳されます。
XMethodsからの応答は次のとおりです-
HTTP/1.1 200 OK
Date: Sat, 09 Jun 2001 15:01:55 GMT
Server: Apache/1.3.14 (Unix) tomcat/1.0 PHP/4.0.1pl2
SOAPServer: SOAP::Lite/Perl/0.50
Cache-Control: s-maxage = 60, proxy-revalidate
Content-Length: 539
Content-Type: text/xml
<?xml version = "1.0" encoding = "UTF-8"?>
<SOAP-ENV:Envelope
xmlns:SOAP-ENC = "http://schemas.xmlsoap.org/soap/encoding/"
SOAP-ENV:encodingStyle = "http://schemas.xmlsoap.org/soap/encoding/"
xmlns:xsi = "http://www.w3.org/1999/XMLSchema-instance"
xmlns:SOAP-ENV = "http://schemas.xmlsoap.org/soap/envelope/"
xmlns:xsd = "http://www.w3.org/1999/XMLSchema">
<SOAP-ENV:Body>
<namesp1:BabelFishResponse xmlns:namesp1 = "urn:xmethodsBabelFish">
<return xsi:type = "xsd:string">Bonjour, monde!</return>
</namesp1:BabelFishResponse>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
HTTP経由で配信されるSOAP応答は、同じHTTPステータスコードに従う必要があります。たとえば、ステータスコード200 OKは、正常な応答を示します。500 Internal Server Errorのステータスコードは、サーバーエラーがあり、SOAP応答にFault要素が含まれていることを示します。