JAX-WS ベースのバージョン 7.0 WS-Notification サービスで (ハンドラー・リストの一部として) 使用されるハンドラーの Java™ API
for XML-based Web Services (JAX-WS) ハンドラー構成を変更します。
始める前に
JAX-WS ハンドラー構成の変更は、このトピックに説明されているように管理コンソールを使用するか、
または modifyJAXWSHandler コマンドを使用して行うことができます。
ハンドラー・クラスを変更するが、クラス名は変更しない場合、ハンドラー構成をこのトピックで説明されているように変更する必要はありません。
このハンドラーがモニターするサービスまたはサービス・ポイントをホストするサーバーまたはクラスターを停止して、再始動するだけで済みます。
このタスクについて
Java
API for XML-based Web Services (JAX-WS) ハンドラーは、一定範囲の処理タスクを実行する
Java
クラスです。 例えば、メッセージのロギング、コンテンツの変換、着信要求の終了などを実行します。管理コンソールを使用して、既存のハンドラー構成をリストしたり、それらの構成の詳細を表示および変更したりすることができます。
手順
- 管理コンソールを開始します。
- の順に進みます。 ハンドラーのリストが JAX-WS ハンドラー・コレクション・フォームに表示されます。
- このリスト内でハンドラーの名前をクリックします。 そのハンドラーの現在の JAX-WS ハンドラー設定が表示されます。
- 以下の一般プロパティーを変更します。
- 名前
- ハンドラーの名前を変更します。
この名前はすべてのセル有効範囲で固有である必要があり、以下の構文規則に従っている必要があります。
- 「.」(ピリオド) で開始しないようにする必要があります。
- スペースで開始または終了しないようにする必要があります。
- ¥/ , # $ @ : ; " * ? < > | = + & % ' のいずれも含まないようにする必要があります。
注: ハンドラー名を変更すると、システムによって、このハンドラーを参照するすべてのオブジェクトが検索され、名前が更新されます。
- 説明
- ハンドラーの説明 (オプション) を変更します。
- クラス名
- インスタンス化するクラスの名前を変更します。
- クラス名を変更する場合は、JAX-WS ハンドラー・クラスのロードで説明されているように、モニターしたい WS-Notification サービス・ポイント (インバウンド呼び出し処理の場合) または WS-Notification サービス (アウトバウンド呼び出し処理の場合) をホストするサーバーまたはクラスターで新しいハンドラー・クラスを使用できるようにすることも必要です。
注: 別々のハンドラー名を持つ個々のインスタンスを作成して同じハンドラークラスに指定することにより、ハンドラーの複数インスタンスを構成できます。
- 変更をマスター構成に保存します。
タスクの結果
処理が正常に終了すると、ハンドラーのリストが再度表示されます。正常に終了しなかった場合は、エラー・メッセージが表示されます。