|
|
JMS は、すべてのサービス タイプのプロキシ サービスおよびビジネス サービス (転送型付きサービスのビジネス サービスを除く) の転送プロトコルとして選択できます。以下の各節で説明するように、プロキシ サービスおよびビジネス サービスは JMS 転送を使用するようにコンフィグレーションできます。
詳細については、『Oracle Service Bus Console の使い方』の「ビジネス サービス : 作成と管理」および「プロキシ サービス : 作成と管理」を参照してください。ビジネス サービスのエラー処理については、「エラー処理」を参照してください。
プロキシ サービスをコンフィグレーションする場合は、転送ヘッダ アクションを使用してメッセージのヘッダ値を設定できます。詳細については、「転送ヘッダ」を参照してください。
Oracle Service Bus の WebSphere MQ との相互運用性については、ネイティブ MQ 転送ユーザーズ ガイドの「WebSphere JMS MQ インタフェースの使用」を参照してください。
Oracle Service Bus では、サービスをコンフィグレーションする (または、必要に応じて WLS でカスタム ワーク マネージャをコンフィグレーションする) 際にデフォルトのディスパッチ ポリシーを使用できます。詳細については、『WS 転送ユーザーズ ガイド』の「WS 転送の使用」にあるワーク マネージャの作成を参照してください。
プロキシ サービスをコンフィグレーションするときに、エンドポイント URI が次の形式の場合、JMS 転送プロトコルを選択できます。
jms://<host:port[,host:port]*/factoryJndiName/destJndiName>
host は、サービスをホストするシステムの名前です。
クラスタでは : JMS URI にあるホスト名は WebLogic Server 内でコンフィグレーションされているクラスタ サーバのホスト名と正確に一致する必要がある。
port : 接続を行うポート番号。[,host:port]* : 対応するポートで複数のホストをコンフィグレーションできることを示します。factoryJndiName : JNDI 接続ファクトリの名前destJndiName : JNDI 送り先の名前。
JMS 送り先を複数のサーバにするには、次の URI の形式を使用します。jms://host1:port,host2:port/QueueConnectionFactory/destJndiNameここで、 QueueConnectionFactory は接続ファクトリのキューの名前です。接続ファクトリのキューの定義方法の詳細については、『Administration Console オンライン ヘルプ』の「JMS システム モジュールのリソースのコンフィグレーション」を参照してください。
JMS 転送プロトコルを使用してプロキシ サービスをコンフィグレーションするには、以下のフィールドに値を指定する必要があります。
| 注意 : | [応答 URI] フィールドは、応答メッセージに対して [JMSCorrelationID] 設計パターンを選択した場合にのみアクティブになります |
JMSReplyTo 送り先に応答を送信する場合は、メッセージに対して [JMSMessageID] 設計パターンを選択できます| 注意 : | [応答接続ファクトリ] フィールドは、応答メッセージに対して [JMSMessageID] 設計パターンを選択した場合にのみアクティブになります |
UTF-8 です。UTF-8 です。
[ディスパッチ ポリシー] : エンドポイントのディスパッチ ポリシーを指定します。デフォルトのディスパッチ ポリシーに加え、他のディスパッチ ポリシーも使用するには、WebLogic Server Administration Console でワーク マネージャをコンフィグレーションする必要があります。ワーク マネージャの詳細については、「ワーク マネージャを使用したスケジューリング済み作業の最適化」および WebLogic Server の『Administration Console オンライン ヘルプ』の「ワークマネージャの作成」を参照してください。
アイコンをクリックして、詳細設定セクションを展開します。このセクションのパラメータのコンフィグレーションは省略可能です。
JMS 転送を使用したプロキシ サービスのコンフィグレーションの詳細については、『Oracle Service Bus Console の使い方』の「プロキシ サービス : 作成と管理」にある「JMS 転送コンフィグレーション ページ」を参照してください。
JMS 転送に関連する各種のヘッダを表 3-1 に示します。順序単位ヘッダ (JMS_BEA_UnitOfOrder) を除き、すべてのヘッダは発信要求と着信応答の両方で共通になっています。
|
メッセージ フローでは、着信要求および発信要求の両方について転送ヘッダをコンフィグレーションできます。JMS 転送に関連する転送ヘッダについては、「転送ヘッダ」を参照してください。
パイプラインで、転送ヘッダ アクションを使用してメッセージのヘッダの値を設定します。転送ヘッダ アクションの追加については、『Oracle Service Bus Console の使い方』の「転送ヘッダ アクションの追加」参照してください。
| 注意·:· | JMS 転送ヘッダの制限については、『Oracle Service Bus Console の使い方』の「テスト コンソールでのランタイムによる転送設定の使用方法」および『Oracle Service Bus ユーザーズ ガイド』の メッセージ フローの作成にある「転送ヘッダ アクションで指定する転送ヘッダの値の制限」を参照してください。 |
ビジネス サービスをコンフィグレーションするときに、エンドポイント URI が次の形式の場合、JMS 転送プロトコルを選択できます。
jms://<host:port[,host:port]*/factoryJndiName/destJndiName >
host は、サービスをホストするシステムの名前です。
クラスタでは : JMS URI にあるホスト名は WebLogic Server 内でコンフィグレーションされているクラスタ サーバのホスト名と正確に一致する必要がある。
port : 接続を行うポート番号。[,host:port]* : 対応するポートで複数のホストをコンフィグレーションできることを示します。factoryJndiName : JNDI 接続ファクトリの名前destJndiName : JNDI 送り先の名前。
JMS 送り先を複数のサーバにするには、次の URI の形式を使用します。jms://host1:port,host2:port/QueueConnectionFactory/destJndiName
ここで、QueueConnectionFactory は接続ファクトリのキューの名前です。接続ファクトリのキューの定義方法の詳細については、『Administration Console オンライン ヘルプ』の「JMS システム モジュールのリソースのコンフィグレーション」を参照してください。
JMS ビジネス サービスを登録する場合、WSDL ファイルの URI をサービス定義に追加するときに、手動で編集する必要があります。URI の形式は次のとおりです。
jms://<host>:<port>/factoryJndiName/destJndiName
JMS 転送プロトコルを使用してビジネス サービスをコンフィグレーションするには、以下のフィールドに値を指定する必要があります。
| 注意 : | [応答 URI] フィールドは、応答メッセージに対して [JMSCorrelationID] 設計パターンを選択した場合にのみアクティブになります |
JMSReplyTo 送り先に応答を送信する場合は、メッセージに対して [JMSMessageID] 設計パターンを選択する必要があります| 注意 : | [応答接続ファクトリ] フィールドは、応答メッセージに対して [JMSMessageID] 設計パターンを選択した場合にのみアクティブになります |
UTF-8 です。UTF-8 です。0 を指定すると、メッセージは無期限になります。| 注意 : | この機能は、WebLogic Server 9.0 でサポートされています。 |
| 注意 : | ビジネス サービスで JMS ID による応答相関を使用するように JMS 要求/応答アプリケーションをコンフィグレーションするには、以下の作業を行う必要があります。 |
アプリケーション エラーおよび通信エラーを処理する JMS 転送ビジネス サービスは、以下のようにコンフィグレーションできます。
アプリケーション エラーが発生したときにビジネス サービスのエンドポイント URI を再試行するかどうかを指定できます。詳細については、『Oracle Service Bus Console の使い方』のビジネス サービスの作成とコンフィグレーション - 転送コンフィグレーション ページにある[アプリケーション エラーの再試行] オプションを参照してください。
要求/応答を使用するようにコンフィグレーションされた JMS ビジネス サービスでは、応答 メッセージの System.getProperty("com.bea.wli.sb.transports.jms.ErrorPropertyName", "SERVER_ERROR") プロパティが true である場合にアプリケーション エラーが発生します。このシナリオでは、JMS 転送プロバイダは、TRANSPORT_ERROR_APPLICATION エラー コードを使用してエラー メソッドを呼び出します。
通信エラーが発生したときにビジネス サービスの URI をオフラインにするようにコンフィグレーションできます。ビジネス サービスの操作設定をコンフィグレーションするときに、指定した再試行間隔の後、ビジネス サービスのエンドポイント URI がオフラインになるように設定できます。詳細については、『Oracle Service Bus Console の使い方』の「モニタ」にある「ビジネス サービスの操作設定のコンフィグレーション」および「ビジネス サービスのエンドポイント URI のメトリックの表示」を参照してください。
|