modifyJAXWSHandler コマンド
modifyJAXWSHandler コマンドは、 バージョン 7.0 の WS-Notification サービスでハンドラー・リストの一部として使用されるハンドラーの、 Java™ API for XML ベースの Web サービス (JAX-WS) ハンドラー構成を変更するために使用します。
このトピックで説明されているように wsadmin ツールを使用するか、既存の JAX-WS ハンドラー構成の変更で説明されているように管理コンソールを使用して、 JAX-WS ハンドラー構成を変更することができます。
ハンドラー・クラスを変更するが、クラス名は変更しない場合、ハンドラー構成をこのトピックで説明されているように変更する必要はありません。 このハンドラーがモニターするサービスまたはサービス・ポイントをホストするサーバーまたはクラスターを停止して、再始動するだけで済みます。
コマンドを実行するには、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 クラスです。 例えば、メッセージのロギング、コンテンツの変換、着信要求の終了などを実行します。 このコマンドは、 バージョン 7.0 の WS-Notification サービスでハンドラー・リストの一部として使用できる JAX-WS ハンドラー構成を変更します。
構成オブジェクトは、固有の名前 (name パラメーター) を、JAX-WS ハンドラー実装を参照する Java クラス (className パラメーター) と関連付けます。
ターゲット・オブジェクト
JAX-WS ハンドラー構成オブジェクト。
必須パラメーター
- -name
- JAX-WS ハンドラー構成オブジェクトの名前。この名前はすべてのセル有効範囲で固有である必要があり、以下の構文規則に従っている必要があります。
- 「.」(ピリオド) で開始しないようにする必要があります。
- スペースで開始または終了しないようにする必要があります。
- ¥/ , # $ @ : ; " * ? < > | = + & % ' のいずれも含まないようにする必要があります。
- 注: ハンドラー名を変更すると、システムによって、このハンドラーを参照するすべてのオブジェクトが検索され、名前が更新されます。
- -className
- この構成オブジェクトが表わす JAX-WS ハンドラー・クラスの名前。この名前は、完全修飾 Java クラス名でなければなりません。例えば、com.ibm.jaxws.handler.TestHandler です。
- クラス名を変更する場合は、JAX-WS ハンドラー・クラスのロードで説明されているように、モニターしたい WS-Notification サービス・ポイント (インバウンド呼び出し処理の場合) または WS-Notification サービス (アウトバウンド呼び出し処理の場合) をホストするサーバーまたはクラスターで新しいハンドラー・クラスを使用できるようにすることも必要です。注: 別々のハンドラー名を持つ個々のインスタンスを作成して同じハンドラークラスに指定することにより、ハンドラーの複数インスタンスを構成できます。
条件付きパラメーター
なし。
オプション・パラメーター
- -description
- JAX-WS ハンドラーの説明。
例
- Jython の使用:
AdminTask.modifyJAXWSHandler(JAXWSHandler, ["-name", "newHandler1", "-className", "newHandlerClass", "-description", "newDesc"] )
- Jacl を使用:
$AdminTask modifyJAXWSHandler JAXWSHandler {-name newHandler1 -className newHandlerClass -description newDesc}