第13章 SOAP Over JMS の使用

SOAP over JMS プロトコル は、ほとんどのサービスで使用される慣習的な SOAP/HTTP プロトコルに、より信頼性の高いトランスポート層を提供する方法として、World Wide Web Consortium (W3C) によって定義されています。Apache CXF の実装は、仕様に完全に準拠しており、準拠しているフレームワークと互換性があるはずです。

このトランスポートは JNDI を使用して JMS 宛先を検索します。操作が呼び出されると、リクエストは SOAP メッセージとしてパッケージ化され、JMS メッセージのボディーで指定の宛先に送信されます。

SOAP/JMS トランスポートを使用するには、以下を実行します。

WSDL バインディングを指定する際に、SOAP バインディングが JMS トランスポートを使用するように設定します。soap:binding 要素の transport 属性を http://www.w3.org/2010/soapjms/ に設定します。例13.1「SOAP over JMS バインディングの指定」 は、SOAP/JMS を使用する WSDL バインディングを示しています。

<wsdl:binding ... >
  <soap:binding style="document"
                transport="http://www.w3.org/2010/soapjms/" />
  ...
</wsdl:binding>

エンドポイントの WSDL ポートを指定するときに JMS ターゲット宛先のアドレスを指定します。SOAP/JMS エンドポイントのアドレス指定では、SOAP/HTTP エンドポイントと同じ soap:address 要素および属性を使用します。違いはアドレスの指定です。JMS エンドポイントは、JMS 1.0 の URI スキーム で定義された JMS URI を使用します。例13.2「JMS URI 構文」 は、JMS URI の構文を示しています。

jms:variant:destination?options

表13.1「JMS URI バリアント」 で、JMS URI で使用できるバリアントを説明します。

JMS URI の オプション 部分はトランスポートの設定に使用され、「JMS URI」 で説明されています。

例13.3「SOAP/JMS エンドポイントアドレス」 は、JNDI を使用してターゲット宛先が検索される SOAP/JMS エンドポイントの WSDL ポートエントリーを示しています。

<wsdl:port ... >
  ...
  <soap:address location="jms:jndi:dynamicQueues/test.cxf.jmstransport.queue" />
</wsdl:port>

SOAP/JMS には、JNDI コネクションと JMS トランスポートを設定するための複数の方法が用意されています。