modifyJAXWSHandlerList コマンド
modifyJAXWSHandlerList コマンドは、バージョン 7.0 の WS-Notification サービスで使用するように構成されている、 Java™ API for XML ベースの Web サービス (JAX-WS) ハンドラー・リストの構成詳細を変更をするために使用します。
このトピックで説明されているように wsadmin ツールを使用するか、既存の JAX-WS ハンドラー・リストの変更で説明されているように管理コンソールを使用して、 JAX-WS ハンドラー・リストを変更することができます。
ハンドラー・リストに追加できるのは、以前に構成されたハンドラーのみです。ハンドラーを構成するには、createJAXWSHandler コマンドを参照してください。
コマンドを実行するには、wsadmin スクリプト・クライアントの AdminTask オブジェクトを使用します。
wsadmin スクリプト・クライアントは Qshell から実行されます。.
詳しくは、wsadmin スクリプトを使用した WebSphere スクリプトを実行するための Qshell の構成.
- 使用可能な WS-Notification コマンドのリストと、各コマンドの簡単な説明を見るには、wsadmin プロンプトで以下のコマンドを入力します。
print AdminTask.help('WSNotificationCommands')
- 特定のコマンドの概要ヘルプの場合は、wsadmin プロンプトで以下のコマンドを入力します。
print AdminTask.help('command_name')
AdminConfig.save()
目的
Java API for XML-based Web Services (JAX-WS) ハンドラーは、一定範囲の処理タスクを実行する Java クラスです。 例えば、メッセージのロギング、コンテンツの変換、着信要求の終了などを実行します。 ハンドラーを使用可能にして、より複雑な操作を実行するには、それらのハンドラーをまとめてハンドラー・リストにチェーニングします。 WebSphere® Application Server で行われる方法では、(個々のハンドラーではなく) ハンドラー・リストを WS-Notification サービス・ポイント (インバウンド呼び出し処理の場合) または WS-Notification サービス (アウトバウンド呼び出し処理の場合) に割り当てます。
ターゲット・オブジェクト
JAX-WS ハンドラー・リスト・オブジェクト。
必須パラメーター
- -name
- JAX-WS ハンドラー・リストの名前。この名前はすべてのセル有効範囲で固有である必要があり、以下の構文規則に従っている必要があります。
- 「.」(ピリオド) で開始しないようにする必要があります。
- スペースで開始または終了しないようにする必要があります。
- ¥/ , # $ @ : ; " * ? < > | = + & % ' のいずれも含まないようにする必要があります。
ハンドラー・リスト名を変更すると、システムは、このハンドラーを参照するすべてのオブジェクトを検索して、 名前を更新します。
条件付きパラメーター
なし。
オプション・パラメーター
- -description
- JAX-WS ハンドラー・リストの説明。
- -handlers
- このリストに追加する JAX-WS ハンドラー名のリスト。
指定する各ハンドラー名は、セル有効範囲で JAX-WS ハンドラー・オブジェクトとして存在するものでなければなりません。 ハンドラーは、ハンドラー・リストに表示される順に適用されます。
例
- Jython の使用:
JAXWSHandlerList = AdminTask.modifyJAXWSHandlerList(JAXWSHandlerList, '[-name newHandlerList1 -description newDesc -handlers [[handler1] [handler2]]]')
- Jacl を使用:
$AdminTask modifyJAXWSHandlerList JAXWSHandlerList {-name handlerList1 -description newDesc -handlers {{handler1}{handler2}} }