Java Message Service (JMS) トランスポート・ポリシーの構成
Java™ API for XML-Based Web Services (JAX-WS) アプリケーションで SOAP over JMS を使用する場合は、Java Message Service (JMS) トランスポート・ポリシー構成を 定義することができます。
始める前に
カスタム・ポリシー・セットの場合、一部のポリシー設定を構成することができます。 提供されたデフォルト・ポリシー・セットは、編集できません。 ポリシーを指定するには、デフォルト・ポリシー・セットのコピーを作成するか、 ポリシー・セットを新規作成する必要があります。
このタスクについて
JAX-WS アプリケーションで SOAP over JMS トランスポートを使用する場合は、 JMS トランスポート・ポリシーを構成してトランスポートをカスタマイズすることができます。SOAP over JMS トランスポートでは、クライアントとサーバーとの間で SOAP 要求および応答メッセージをトランスポートするために HTTPS の代替手段が提供されます。このトランスポート・プロトコルの詳細については、 Web サービスをトランスポートするための SOAP over JMS の使用に関する文書を 参照してください。
ポリシーは、ポリシー・セットを通じてのみ構成可能です。 そのため、JMS トランスポート・ポリシーを構成する前に、その JMS トランスポート・ポリシーを含むポリシー・セットが存在している必要があります。JMS トランスポート・ポリシーを含むポリシー・セットをカスタマイズするには、まず最初にポリシー・セットを作成して、JMS トランスポート・ポリシーを新規ポリシー・セットに追加する必要があります。
「JMS トランスポート・ポリシー設定 (JMS transport policy settings)」パネルを使用して、要求タイムアウト値などの、JMS トランスポート・ポリシー・プロパティーの値をカスタマイズします。 JMS トランスポート・ポリシーについてカスタマイズした値が、 そのカスタム JMS トランスポート・ポリシーを含むポリシー・セットに適用されます。 カスタマイズ済みの JMS トランスポート・ポリシーを含むこのポリシー・セットは、JAX-WS アプリケーション、そのサービス、エンドポイント、または操作に関連付けることができます。この変更は、そのポリシー・セットが関連付けられているすべての JAX-WS アプリケーションに影響します。 アプリケーションへのポリシー・セットの関連付けについて詳しくは、アプリケーション・レベルでのサービス・プロバイダーおよびサービス・クライアントのポリシー・セットの管理に関する文書を参照してください。
手順
タスクの結果
JMS トランスポート・ポリシーのカスタマイズが完了すると、 関連付けられたポリシー・セットがこのポリシーを使用して、SOAP over JMS トランスポートのランタイム動作を構成します。
例
アプリケーション、そのサービス、エンドポイント、または操作にポリシー・セットを関連付けることができます。 このシナリオ例では、アプリケーション用に 2 つの異なる JAX-WS サービス・クライアントを使用しているが、サービス・クライアントごとに別の JMS トランスポート要求タイムアウト値を使用するものとします。 JMS 要求タイムアウト値を変更する場合、アプリケーション (この場合、サービス・クライアント) に関連付けられたポリシー・セット内に含まれる JMS トランスポート・ポリシーの値を編集することができます。 この変更内容は、カスタム JMS トランスポート・ポリシーを含むポリシー・セットが関連付けられているすべてのアプリケーションに影響します。
- アプリケーション・サーバーにデプロイされている ServiceClient1 と ServiceClient2 という名前の 2 つの JAX-WS サービス・クライアントがあります。
- JMS トランスポート・ポリシーはまだアプリケーションに関連付けられていません。
- 2 つのポリシー・セットを新規作成して、それらに JMS トランスポート・ポリシーを追加します。
例えば、JMSServiceClient1Policy および JMSServiceClient2Policy のようになります。
- をクリックします。
- 新規アプリケーション・ポリシー・セットの名前 JMSServiceClient1Policy を入力します。
- 「ポリシー」コレクションで、 をクリックします。
- と の順にクリックして、マスター構成に対して行った 変更を保存します。
- 上記手順を繰り返して、JMSServiceClient2Policy を作成します。
- 新規作成した JMSServiceClient1Policy ポリシー・セットと JMSServiceClient2Policy ポリシー・セットの JMS トランスポート・ポリシー設定をカスタマイズします。 例えば、JMSServiceClient1Policy に含まれる JMS トランスポート・ポリシーについて、要求タイムアウト値を 180 秒に設定します。 JMSServiceClient2Policy に含まれる JMS トランスポート・ポリシーについては、要求タイムアウト値に 300 秒を指定します。
- をクリックします。
- 「ポリシー」コレクションで、「 」をクリックします。
- 「JMS トランスポート・ポリシーの構成 (JMS transport policy configuration)」パネルで、要求タイムアウト値に 180 秒を指定します。
- と の順にクリックして、マスター構成に対して行った 変更を保存します。
- をクリックします。
- 「ポリシー」コレクションで、「 」をクリックします。
- 「JMS トランスポート・ポリシーの構成 (JMS transport policy configuration)」パネルで、要求タイムアウト値に 300 秒を指定します。
- と の順にクリックして、マスター構成に対して行った 変更を保存します。
- カスタム JMS トランスポート・ポリシー JMSServiceClient1Policy をアプリケーション ServiceClient1 に関連付けます。 同様に、カスタム JMS トランスポート・ポリシー JMSServiceClient2Policy をアプリケーション ServiceClient2 に関連付けます。
- 「ServiceClient1」をクリックします。
- 「ポリシー・セット関連付け (Policy set attachments)」コレクションから、ServiceClient1 というサービスを選択します。
- 「 」をクリックして、JMSServiceClient1Policy をクリックします。
- 「 」をクリックして、マスター構成に対して行った変更を保存します。
- 「ServiceClient2」をクリックします。
- 「ポリシー・セット関連付け (Policy set attachments)」コレクションから、ServiceClient1 というサービスを選択します。
- 「 」をクリックして、JMSServiceClient2Policy をクリックします。
- 「 」をクリックして、マスター構成に対して行った変更を保存します。
これで、ServiceClient1 アプリケーションに JMSServiceClient1Policy が関連付けられ、JMS セッションで 180 秒の要求タイムアウトが使用されます。 ServiceClient2 アプリケーションには JMSServiceClient2Policy が関連付けられ、JMS セッションで 300 秒の要求タイムアウトが使用されます。
次のタスク
アプリケーションで必要になる可能性のある他のポリシーをカスタマイズすることができます。