Oracle Service Bus と JMS の相互運用性

以下の節では、Oracle Service Bus と WebLogic JMS 間、および Oracle Service Bus と WebSphere MQ 間の相互運用性に関連する機能および概念について説明します。

JMS の相互運用性の概要

Java API for XML-Remote Procedure Call (JAX-RPC) は、J2EE を使用して Web サービスを構築しデプロイするコア Java API と見なすことができます。JAX-RPC は、XML 型と Java 型とのマッピングの複雑さや、XML SOAP メッセージの処理に関する低レベルの詳細を開発者から切り離すことで、Web サービスアプリケーションを構築するための簡単かつ堅牢なプラットフォームを提供します。JAX-RPC は、次の 2 つのプログラミングモデルを提供することによって、メソッド呼び出しパラダイムを導入します。

JAX-RPC では、SOAP の使用と、他のテクノロジによって構築されたその他の Web サービスとの相互運用性が要求されます。ステートレスセッション EJB、またはビジネスロジックを実行する Java クラスがすでにある場合、J2EE 1.4 では JAX-RPC を使用した標準的な方法でサービスとしてエクスポーズできます。

Oracle Service Bus は、次の JMS 実装での動作が確認されています。

すべての Oracle Service Bus のサービスタイプで JMS 転送がサポートされています。プロキシサービスとビジネスサービスで JMS 転送を使用するようにコンフィグレーションする詳細については、『Oracle Bus Console の使い方』の「プロキシサービス : 作成と管理」および「ビジネスサービス : 作成と管理」を参照してください。

Oracle Service Bus のサービスタイプと各サービスタイプの転送方式については、『Oracle Service Bus ユーザーズガイド』の「Oracle Service Bus でのメッセージフローの作成」にある「サービスタイプの選択」を参照してください。

非同期の要求/応答メッセージング

ただし、JMS でのメッセージングは、一方向または非同期の要求/応答のみです。JMS を使用した非同期の要求/応答メッセージングは、HTTP または HTTPS を使用したメッセージングに代わるものです。

非同期の要求/応答メッセージングを使用する利点は次のとおりです。

応答を待機する間、要求スレッドがブロックされることはない。これにより、多数のブロッキング要求/応答呼び出しが行われた場合に生じる可能性のある、スレッドの管理上の問題が解消されます。ただし、HTTP と HTTPS は、操作の非ブロッキングモードをサポートしています。
HTTP よりもメッセージングの信頼性が高い。理由は次のとおりです。

メッセージをディスク上に保持できる。
サービスを利用できないときに、メッセージをキューに置くことができる。
メッセージの処理時にサーバにエラーや障害が発生した場合、メッセージを再配信できる。

IBM WebSphere MQ を使用している場合、特定のメインフレームとの対話には非同期の要求/応答メッセージを使用することをお勧めします。非同期サービスは、使用する JMS 要求/応答パターンに応じて相関 ID またはメッセージ ID を返す必要があります。Oracle Service Bus で使用するどちらの ID 形式も、IBM WebSphere MQ との互換性および MQ ネイティブインタフェースを使用する対象サービスとの互換性があります。詳細については、「JMS 要求/応答のメッセージ ID と相関 ID のパターンについて」を参照してください。

非同期の要求/応答メッセージは、発信転送と着信転送によって処理されます。つまり、転送方式固有のデータである $outbound と $inbound を除き、JMS 要求/応答と HTTP 要求/応答のメッセージフローに違いはありません。

Oracle Service Bus は、同期と非同期の要求/応答のブリッジングをサポートしています。たとえば、HTTP を使用してプロキシサービスを呼び出すことができ、呼び出されたプロキシサービスは、JMS 要求/応答ビジネスサービスにルーティングされます。これを同期から非同期へのサービスの切り替えと呼びます。

SOAP/JMS 転送の使用

SOAP は転送方式に依存しないため、SOAP 転送で HTTP の代わりに JMS を使用できます。特に企業顧客の場合、SOAP/JMS 転送が必要となります。Oracle Service Bus は、JMS 要求/応答での SOAP メッセージをサポートしています。また、SOAP ベースの WebLogic Server クライアントおよびサービスとの相互運用もサポートしています。

この節では、次のような SOAP/JMS の相互運用の例を示します。

Oracle WebLogic Server 9.x および 10.0 との相互運用

JMS バインディングを使用して WebLogic Server 9.x および 10.0 のサービスをコンフィグレーションする場合は、WebLogic Server で次の SOAP/JMS URL 形式を使用します。

Oracle Service Bus でサービスをコンフィグレーションする場合、URL は次の形式で指定する必要があります。

どちらの形式でも同じ destJndiName を使用します。factoryJndiName は、対象 WebLogic Server の既存の QueueConnectionFactory の JNDI 名である必要があります。

Oracle Service Bus から Oracle WebLogic Server サービスを呼び出す場合は、要求をビジネスサービスに送信する前に、メッセージフロー内で発信変数 ($outbound) に値 /contextURI/serviceName の JMS プロパティとして URI を設定する必要があります。このプロパティを設定するには、転送ヘッダアクションを使用します。

$outbound の設定については、『Oracle Service Bus ユーザーズガイド』の「メッセージコンテキスト」にある「inbound 変数と outbound 変数」を参照してください。

WebLogic Server 9.x および 10.0 Web Services クライアントから Oracle Service Bus プロキシサービスを呼び出す場合、URI プロパティは無視されます。ただし、転送ヘッダアクションのパススルーオプションを使用すると、呼び出されるサービスにパススルーできます。詳細については、『Oracle Service Bus Console の使い方』の「プロキシサービス : アクション」にある「転送ヘッダアクションの追加」を参照してください。

Oracle Service Bus で呼び出すことができるのは、バージョン 9.2 以降で実行されている WebLogic 要求/応答サービスのみです。ただし、一方向の JMS サービスも呼び出すことができます。

ドメイン間 JMS 呼び出しの応答キューのコンフィグレーション

ドメイン間 JMS 呼び出しの応答キューをコンフィグレーションする場合は、要求側の管理対象サーバごとに個別の応答キューを設定します。次に例を示します。

WLS ドメインと通信する 2 つの Oracle Service Bus クラスタドメイン (ドメイン A とドメイン B) があります。この WLS ドメインには、2 つの管理対象サーバがあるとします。ドメイン A に 3 つの管理対象サーバ、ドメイン B に 4 つの管理対象サーバがある場合、ドメイン A とドメイン B に応答を返すには、応答キューとして機能する 7 つ (3 + 4 = 7) の異なるキューを WLS ドメインにコンフィグレーションする必要があります。これらのキューは、(WLS ドメインの両方の管理対象サーバにメンバーを持つ) 分散キューである場合もあります。

Oracle WebLogic Workshop 8.1 との相互運用

JMS バインディングを使用して Oracle WebLogic Workshop 8.1 のビジネスサービスをコンフィグレーションする場合は、Oracle WebLogic Workshop で次の SOAP/JMS URL 形式を使用します。

Oracle Service Bus から Oracle WebLogic Workshop サービスを呼び出す場合は、メッセージを送信する前に、メッセージフロー内で発信変数 ($outbound) に JMS プロパティとしてこの URI を設定する必要があります。このプロパティを設定するには、転送ヘッダアクションを使用します。詳細については、『Oracle Service Bus Console の使い方』の「プロキシサービス : アクション」にある「転送ヘッダアクションの追加」を参照してください。

WebLogic Workshop クライアント (コントロールなど) が Oracle Service Bus プロキシサービスを呼び出す場合、URI プロパティは無視されます。ただし、転送ヘッダアクションのパススルーオプションを使用すると、呼び出されるサービスにパススルーできます。

Oracle Service Bus では、WebLogic 8.1 の JMS 要求/応答サービスを呼び出すことはできません。ただし、一方向の JMS サービスは呼び出すことができます。

Oracle WebLogic Server 8.1 との相互運用

JMS バインディングを使用して WebLogic Server 8.1 のビジネスサービスをコンフィグレーションする場合は、WebLogic Server で次の SOAP/JMS URL 形式を使用します。

この形式は、前の節で示した Oracle Service Bus JMS URL 形式とは異なります。Oracle Service Bus から Oracle WebLogic Workshop サービスを呼び出す場合は、要求をビジネスサービスに送信する前に、メッセージフロー内で発信変数 ($outbound) に JMS プロパティとしてこの URI を設定する必要があります。このプロパティを設定するには、転送ヘッダアクションを使用します。

WebLogic Server 8.1 Web Services クライアントが Oracle Service Bus プロキシサービスを呼び出す場合、URI プロパティは無視されます。ただし、転送ヘッダアクションのパススルーオプションを使用すると、呼び出されるサービスにパススルーできます。詳細については、『Oracle Service Bus Console の使い方』の「プロキシサービス : アクション」にある「転送ヘッダアクションの追加」を参照してください。

ドメイン、WebLogic、および JMS サーバの命名ガイドライン

複数のドメインを使用する作業では、コンフィグレーションが次の要件に準拠していることを確認します。

同じドメインに重複した JMS サーバ名を持つことはできない。重複した JMS サーバ名があると、メッセージが特定の JMS サーバの送り先に送信されたときに、Oracle Service Bus はメッセージの送信先のサーバを判別できません。
ストアアンドフォワード (SAF) を使用している場合は、異なるドメインに重複した JMS サーバ名があってもかまわない。
ドメイン間通信の場合、ReplyTo 機能を使用するときに、重複した JMS サーバ名が問題になることがある。特定のドメインから送信された ReplyTo メッセージは、元のメッセージを送信したドメインではなく、そのメッセージを受信した同じドメイン上の JMS サーバに返されます。

WebLogic JMS のコンフィグレーションと管理方法については、以下を参照してください。

サービスの JMS タイプの指定

Oracle Service Bus では、異種のエンドポイント間での相互運用性を確保するため、使用されるコンテンツタイプ、JMS タイプ、およびエンコーディングをメッセージフローのコンフィグレーション時にそれぞれ制御できます。JMS タイプは、バイトまたはテキストのいずれかです。詳細については、『Oracle Service Bus ユーザーズガイド』の「Oracle Service Bus でのメッセージフローの作成」にある「コンテンツタイプ、JMS タイプ、およびエンコーディング」を参照してください。

WSDL 定義の SOAP エラーメッセージ

明示的にエラーを定義する WSDL を使用している場合、XML エラーのタイプに対し、WebLogic clientgen ツールによって java.lang.Exception というサブクラスが生成されます。WebLogic Server JAX-RPC スタックが SOAP 応答メッセージを検査し、応答メッセージに SOAP エラーが含まれると判断すると、そのエラーを clientgen 生成の例外 Java クラスにマップしようとします。

たとえば、次のコードリストに示す定義が WSDL に含まれる場合、clientgen ツールは java.lang.Exception を拡張した com.bea.test.TheFaultType Java クラスを生成します。このサービススタブの関連メソッドが呼び出されると、JAX-RPC クライアントが com.bea.test.TheFaultType を受け取る可能性があります。

<definitions ... xmlns:s0="http://www.oracle.com/test/">
   ...
   <types>
      <xsd:schema targetNamespace="http://www.oracle.com/test/">
         ...
         <xsd:complexType name="theFaultType">
            <xsd:sequence>
               <xsd:element name="ID" type="xsd:int" />
               <xsd:element name="message" type="xsd:string" />
            </xsd:sequence>
         </xsd:complexType>
         <xsd:element name="theFault" type="theFaultType" />
      </xsd:schema>
   </types>
   ...
   <message name="theFaultMessage">
      <part element="s0:theFaultPart" name="theFault" />
   </message>
   ...
   <binding ...>
      <operation ...>
         <soap:operation soapAction="..." style="document" />
         <input ...>
            ...
         </input>
         <output ...>
            ...
         </output>
         <fault ...>
            <soap:fault name="theFaultPart" use="literal" />
         </fault>
      </operation>
   </binding>
   ...
</definitions>

SOAP メッセージには正しい形式のエラーが含まれ、JAX-RPC スタックが正しい例外をスローできるようになっている必要があります。エラーを Oracle Service Bus メッセージフロー内部で作成する場合は、次の操作を行います。

$body 変数のノードを次の SOAP のサンプルで置き換えます。

コードリスト 1-2 SOAP のサンプル

<soap-env:Body> 
      <soap-env:Fault> 
         <faultcode
xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">soap:Server</faultcode>
         <faultstring>Some literal string</faultstring>
         <detail>
            <test:theFault>
               <test:ID>Any user defined code</test:Id>
               <test:message>A specific literal message</test:message>
            </test:theFault>
         </detail>
      </soap-env:Fault>
</soap-env:Body>

ここで、

soap-env - http://schemas.xmlsoap.org/soap/envelope/ ネームスペースのシステムプレフィックス。
test - http://www.oracle.com/test/ ネームスペースのプレフィックス。

test プレフィックスが Oracle Service Bus にとって既知ではない場合は、宣言する必要があります。

失敗時の返信アクションをコンフィグレーションします。

Oracle Service Bus Console での返信アクションのコンフィグレーションについては、『Oracle Service Bus Console の使い方』の「プロキシサービス : アクション」を参照してください。

clientgen ツールは、JAX-RPC スタブなど、Web サービスを呼び出すために必要なクライアント側アーティファクトを生成するために使用します。『WebLogic Web サービスリファレンスガイド』の「Ant タスクリファレンス」を参照してください。

WebSphere MQ との相互運用性

Oracle Service Bus は、WebSphere MQ JMS インタフェースを介して WebSphere MQ に接続します。つまり、Oracle Service Bus は WebSphere MQ JMS クライアントです。

WebSphere MQ は、次の 2 通りの方法で Oracle Service Bus と対話できます。

JMS の相互運用性ソリューション