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