JAX-WS ベースのバージョン 7.0 WS-Notification サービスで (ハンドラー・リストの一部として) 使用される Java™ API
for XML-based Web Services (JAX-WS) ハンドラー
構成を作成します。
始める前に
新規 JAX-WS ハンドラー構成の作成は、このトピックに説明されているように管理コンソールを使用するか、
または createJAXWSHandler コマンドを使用して行うことができます。
このタスクは、既にハンドラーを作成していることを前提としています。
これは、IBM® Rational® Application Developer または同様のツールを使用して実行できます。 JAX-WS ハンドラー・クラスのロードで説明されているように、モニターしたい WS-Notification サービス・ポイント (インバウンド呼び出し処理の場合) または WS-Notification サービス (アウトバウンド呼び出し処理の場合) をホストするサーバーまたはクラスターでハンドラー・クラスが使用できるようにすることも必要です。
このタスクについて
Java
API for XML-based Web Services (JAX-WS) ハンドラーは、一定範囲の処理タスクを実行する
Java
クラスです。 例えば、メッセージのロギング、コンテンツの変換、着信要求の終了などを実行します。 WebSphere® Application Server がハンドラーを認識するようにし、またハンドラーが 1 つ以上のハンドラー・リストに包含されることを可能にするには、管理コンソールを使用して、新しいハンドラー構成を作成します。
手順
- 管理コンソールを開始します。
- の順に進みます。 JAX-WS ハンドラー・コレクション・フォームが表示されます。
- 「新規」をクリックします。 JAX-WS ハンドラー設定フォームが表示されます。
- 以下の一般プロパティーを入力します。
- 名前
- ハンドラーが認識される名前を入力します。
この名前はすべてのセル有効範囲で固有である必要があり、以下の構文規則に従っている必要があります。
- 「.」(ピリオド) で開始しないようにする必要があります。
- スペースで開始または終了しないようにする必要があります。
- ¥/ , # $ @ : ; " * ? < > | = + & % ' のいずれも含まないようにする必要があります。
例えば、TestHandler です。
- 説明
- ハンドラーの説明 (オプション) を入力します。
- クラス名
- インスタンス化するクラス名を入力します。この名前は、
完全修飾 Java クラス名でなければなりません。例えば、com.ibm.jaxws.handler.TestHandler です。
注: 別々のハンドラー名を持つ個々のインスタンスを作成して同じハンドラークラスに指定することにより、ハンドラーの複数インスタンスを構成できます。
- 「OK」をクリックします。 この項目の一般プロパティーが保存され、
追加プロパティー・オプションが使用できるようになります。
- 変更をマスター構成に保存します。
タスクの結果
処理が正常に終了すると、ハンドラーのリストが更新され、新規ハンドラーが追加されます。
正常に終了しなかった場合は、エラー・メッセージが表示されます。
次のタスク
このハンドラーを使用するには、それをハンドラー・リストに追加します。
新規 JAX-WS ハンドラー・リストの作成、または
既存の JAX-WS ハンドラー・リストの変更を参照してください。