Java™ API for XML Web Services (JAX-WS) クライアントまたは
Web サービスによる Web Services Atomic Transaction (WS-AT) または Web Services Business Activity
(WS-BA) コンテキストの処理方法を構成できます。これは、Web サービス・トランザクション (WS-Transaction) のポリシー・タイプを構成することで行います。クライアントまたはサービスによるコンテキストの使用を必須にするか、
使用可能である場合に使用できるようにする、またはコンテキストを使用しないように指定できます。Web サービス・トランザクションのポリシー・セットを構成するには、次のコマンド・スクリプトを使用します。
このタスクについて
このタスクで説明されているように、wsadmin スクリプトを使用して WS-Transaction ポリシー・セットを構成したり、管理コンソールを使用して WS-Transaction ポリシー・セットを構成することができます。
注: WS-Transaction ポリシー・セット
のサポートは、アプリケーションおよびサービスのレベルにのみ存在します。
管理コンソールでは、WS-Transaction ポリシー/バインディングをエンドポイント
またはオペレーションのレベル (あるいは両方) で添付することが可能ですが、
実際には影響はありません。
手順
- wsadmin スクリプト・クライアントがまだ実行されていない場合は、それを開始します。
- createPolicySet コマンドを使用して新規ポリシー・セットを作成するか、
copyPolicySet コマンドを使用して既存のポリシー・セットをコピーし、名前を変更します。
既存のユーザー定義のポリシー・セット、またはいずれかの WS-Transaction
デフォルト・ポリシー・セット (WSTransaction または SSL WSTransaction) をコピーできます。
- ポリシー・セットに WS-Transaction ポリシー・タイプが含まれることを確認してください。
必要に応じて、WS-Transaction ポリシー・タイプを追加します。 以下に例を示します。
AdminTask.importPolicySet('[-defaultPolicySet WSTransaction]')
AdminTask.addPolicyType('[-policySet policy_set_name
-policyType WSTransaction -enabled true]')
- setPolicyType コマンドを使用して、WS-Transaction ポリシー・タイプ属性を構成します。 WS-Transaction ポリシー・タイプには、以下の属性があります。
- ATAssertion
- BAAtomicOutcomeAssertion
それぞれの属性の値には、supports、mandatory、または never を設定できます。
これらの構成可能属性について詳しくは、WS-Transaction のポリシー設定に関する各トピックを参照してください。 以下に例を示します。AdminTask.setPolicyType('[-policySet policy_set_name
-policyType WSTransaction
-attributes "[ [BAAtomicOutcomeAssertion mandatory] [ATAssertion supports] ]"]
-replace')
- 変更をマスター構成に保存します. 例えば、以下のコマンドを入力します。
AdminConfig.save()
次のタスク
ポリシー・セットを JAX-WS クライアント、
または JAX-WS Web サービス、エンドポイント、操作に関連付ける準備ができました。