既存の JAX-WS ハンドラー・リストの変更

JAX-WS ベースのバージョン 7.0 WS-Notification サービスで使用するよう構成された Java™ API for XML-based Web Services (JAX-WS) ハンドラー・リスト の構成詳細を変更します。

始める前に

JAX-WS ハンドラー・リストの変更は、このトピックに説明されているように管理コンソールを使用するか、 または modifyJAXWSHandlerList コマンドを使用して行うことができます。

ハンドラー・リストに追加できるのは、以前に構成されたハンドラーのみです。ハンドラーを構成するには、新規 JAX-WS ハンドラー構成の作成を参照してください。

このタスクについて

Java API for XML-based Web Services (JAX-WS) ハンドラーは、一定範囲の処理タスクを実行する Java クラスです。 例えば、メッセージのロギング、コンテンツの変換、着信要求の終了などを実行します。 ハンドラーを使用可能にして、より複雑な操作を実行するには、それらのハンドラーをまとめてハンドラー・リストにチェーニングします。 WebSphere® Application Server で行われる方法では、(個々のハンドラーではなく) ハンドラー・リストを WS-Notification サービス・ポイント (インバウンド呼び出し処理の場合) または WS-Notification サービス (アウトバウンド呼び出し処理の場合) に割り当てます。

管理コンソールを使用して、既存のすべてのハンドラー・リストを表示したり、それらの構成の詳細を表示および変更したりすることができます。

手順

  1. 管理コンソールを開始します。
  2. サービス統合 ->「WS-Notification」 ->「JAX-WS ハンドラー・リスト」の順に進みます。 すべてのハンドラー・リストのリストが JAX-WS ハンドラー・リスト・コレクション・フォームに表示されます。
  3. このリスト内でハンドラー・リストの名前をクリックします。 そのハンドラーの現在の JAX-WS ハンドラー・リスト設定が表示されます。
  4. 以下の一般プロパティーを変更します。
    名前
    ハンドラー・リストの名前を変更します。
    この名前はすべてのセル有効範囲で固有である必要があり、以下の構文規則に従っている必要があります。
    • 「.」(ピリオド) で開始しないようにする必要があります。
    • スペースで開始または終了しないようにする必要があります。
    • ¥/ , # $ @ : ; " * ? < > | = + & % ' のいずれも含まないようにする必要があります。

    ハンドラー・リスト名を変更すると、システムは、このハンドラーを参照するすべてのオブジェクトを検索して、 名前を更新します。

    説明
    ハンドラー・リストの説明 (オプション) を変更します。
    JAX-WS ハンドラー
    JAX-WS ハンドラー・ペインで、以下のステップを実行します。
    1. 使用可能な JAX-WS ハンドラーのリスト、またはこの JAX-WS ハンドラー・リスト用のハンドラーのリストのいずれかから、以前に構成された 1 つ以上のハンドラーを選択し、「追加」または「除去」をクリックして、この JAX-WS ハンドラー・リスト用のハンドラーのリストを変更します。
    2. リスト内のハンドラーの位置を変更するには、この JAX-WS ハンドラー・リスト用のハンドラーのリストでハンドラーを選択してから、「上へ」または「下へ」をクリックします。
    ハンドラーは、ハンドラー・リストに表示される順に適用されます。
    注: 「リセット」をクリックすると、 「名前」フィールドと「説明」フィールドのみが、フォームが最初にロードされたときの状態にリセットされます。使用可能で割り当て済みのハンドラーの 2 つのリストは、リセットされません。
  5. 変更をマスター構成に保存します。

タスクの結果

処理が正常に終了すると、ハンドラー・リストのリストが再度表示されます。 正常に終了しなかった場合は、エラー・メッセージが表示されます。

次のタスク

このハンドラー・リストをバージョン 7.0 WS-Notification ポイントで受信されるインバウンド通知要求に適用する場合は、このハンドラー・リストを対象のサービス・ポイントに関連付けます (新規のバージョン 7.0 WS-Notification サービス・ポイントの作成またはバージョン 7.0 WS-Notification サービス・ポイントの変更を参照してください)。このハンドラー・リストをバージョン 7.0 WS-Notification サービスによって送信されるアウトバウンド通知要求に適用する場合は、このハンドラー・リストを対象のサービスに関連付けます (新規のバージョン 7.0 WS-Notification サービスの作成またはバージョン 7.0 WS-Notification サービスの変更を参照してください)。

JAX-WS ハンドラーを作成し、作成したハンドラーをチェーニングしてハンドラー・リストにし、さらにそのハンドラー・リストをバージョン 7.0 WS-Notification サービス・ポイントまたはサービスに適用するエンドツーエンド・タスクの概要については、WS-Notification サービスへの JAX-WS ハンドラー・リストの適用を参照してください。


トピックのタイプを示すアイコン タスク・トピック



タイム・スタンプ・アイコン 最終更新: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=tjwsn_jaxws_handler_list_mod
ファイル名:tjwsn_jaxws_handler_list_mod.html