SOAP ノードは、Web サービス処理が構成されて適用される場所であるフロー内のポイントとして機能します。 SOAP ノード上のプロパティーは、実行される処理を制御します。WSDL 定義の指定、プロパティーの手動構成、またはこの両方を行って、このプロパティーを構成することができます。
SOAP ノード
- SOAPInput および SOAPReply ノードは、Web サービスを実装するメッセージ・フロー内で使用されます。 これらの SOAP ノードは、Web サービス・プロバイダーをインプリメントするメッセージ・フローを構成するのに使用されます。
SOAPInput ノードは Web サービス要求の着信を listen し、SOAPReply は応答をクライアントに返送します。SOAPInput ノードおよびSOAPReply ノードを参照してください。
- クライアントは、フローで公開されているエンドポイントに、照会ストリング ?wsdl の接尾部を付けて HTTP GET 要求を送信し、フローの構成で使用された WSDL 定義の応答を受信できます。 詳しい説明については、WSDL を使用したメッセージ・フローの構成を参照してください。
- SOAPRequest ノードは、メッセージ・フロー中で Web サービス・プロバイダーを同期的に呼び出すために使用されます。
Web サービスを同期で呼び出すとは、ノードが、Web サービス要求を送信した後、メッセージ・フローをブロックしながら、それに対する Web サービス応答が着信するまで待機し、その後メッセージ・フローが続行されることを意味します。SOAPRequest ノードを参照してください。
- SOAPAsyncRequest および SOAPAsyncResponse ノードは、Web サービスを非同期で呼び出すメッセージ・フロー (またはフローのペア) を構成するのに使用されます。 Web サービスを非同期で呼び出すとは、SOAPAsyncRequest ノードが Web サービス要求を送信した後、対応する Web サービス応答が着信するまで、この要求がメッセージ・フローをブロックしながら待機しないことを意味します。Web サービス応答は、別のフロー内にある SOAPAsyncResponse ノードで受信されるためです。 ノード相関関係子は、元の要求に対する応答の論理ペアを識別します。 したがって、複数の要求を並行して処理することができます。SOAPAsyncRequest ノードおよびSOAPAsyncResponse ノードを参照してください。
- SOAPExtract ノードと SOAPEnvelope ノードを使用して、SOAP 本体のペイロードを処理できます。 SOAPExtract ノードは、SOAP ドメインと相互運用することができます。
SOAP ノードは非 SOAP メッセージを直接処理できるので SOAPEnvelope ノードは必要ありませんが、HTTP ノードには SOAPEnvelope ノードがやはり必要です。 SOAPExtract ノードおよびSOAPEnvelope ノードを参照してください。
- SOAP ノードの動作モードを変更して、ゲートウェイ・モードで作動させることができます。 ゲートウェイ・モードでは、ノードを構成するための WSDL は必要ありません。ノードは、特定の WSDL に結合されない汎用要求/応答および片方向 SOAP メッセージを扱うからです。 詳細については、SOAP ノードでのゲートウェイ動作モードを参照してください。
W3C の SOAP 仕様では、アプリケーション・ロジックの単位という意味で「SOAP ノード」という表現を使用しています (Web Services Glossary を参照してください)。 通常、WebSphere® Message
Broker インフォメーション・センターで「SOAP ノード」と記載されている場合、それは WebSphere Message
Broker SOAP ノードを指します。
単一のブローカーのメッセージ・フローで SOAP ノードおよび HTTP ノードを使用している場合、ブローカー・リスナーと組み込みの実行グループ・リスナーのいずれかを使用して HTTP メッセージを処理するように選択できます。
構成でのリスナーが、SOAPInput ノードと HTTPInput ノードの両方とも取得する可能性のあるメッセージを受け取る場合、それらのノードの URL 指定を注意深く確認する必要があります。 両方の URL 指定が着信メッセージと一致する場合は、正しくないタイプのノードがメッセージを取得する可能性があり、処理が失敗するか予期しない結果が生じることがあります。 この状況は、HTTPInput ノードおよび SOAPInput ノードの「URL のパス接尾部」プロパティーに同一の値を指定した場合に起こります。 また、いずれか、または両方の指定でワイルドカードを使用し、着信メッセージが両方のプロパティーとマッチングする場合にも起こります。