Interstage Service Integrator 解説書

2.4.4 SOAPメッセージの操作(SOAP Operation)

SOAP Operationを利用して、SOAPメッセージを操作します。
SOAP Operationの主な機能は、以下のとおりです。

• SOAPメッセージの作成
• SOAPメッセージからボディ要素の情報取得
• SOAPメッセージからヘッダ要素の情報取得

■SOAPメッセージの作成

SOAP GatewayでWebサービスへ送信するためのSOAPメッセージを作成します。作成したSOAPメッセージは、共通メッセージのペイロードに格納されます。
SOAPメッセージの作成には、以下の方法があります。

• ボディ要素だけを指定して作成
• ヘッダ要素とボディ要素を指定して作成

以下は、ボディ要素だけを指定して作成した例です。

[図：SOAP Operationの機能(SOAPメッセージの作成)]

• ヘッダ要素およびボディ要素のXML文書の文字コードは、“UTF-8”を使用することを推奨します。
• 作成したSOAPメッセージの文字コードは、“UTF-8”になります。

■ボディ要素の情報取得

SOAP Gatewayで受信したSOAPメッセージからボディ要素を取得します。取得したボディ要素は、共通メッセージのペイロードに格納されます。

[図：SOAP Operationの機能(ボディ要素の情報取得)]

• 取得元のSOAPメッセージの文字コードは、“UTF-8”だけ使用できます。
• 取得したボディ要素のXML文書の文字コードは、“UTF-8”になります。

■ヘッダ要素の情報取得

SOAP Gatewayで受信したSOAPメッセージからヘッダ要素を取得します。取得したヘッダ要素は、共通メッセージのペイロードに格納されます。
SOAPメッセージのヘッダ要素(SOAPヘッダ)は、標準規約の通信情報など特殊な用途で使用されます。通常のWebサービスでは、ボディ要素(SOAPボディ)だけが使用されます。

スキーマに関する名前空間は、SOAPメッセージから取得したボディ要素・ヘッダ要素に引き継がれます。
ボディ要素の情報取得の例では、SOAPメッセージから取得したXMLデータのルート要素に、以下の名前空間の宣言を追加しています。
xmlns:soapenc="http://shemas.xmlsoap.org/soap/encoding"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

• 取得元のSOAPメッセージの文字コードは、“UTF-8”だけ使用できます。
• 取得したヘッダ要素のXML文書の文字コードは、“UTF-8”になります。