新規 JAX-WS ハンドラー・リストの作成

JAX-WS ベースのバージョン 7.0 WS-Notification サービスで使用するための Java™ API for XML-based Web Services (JAX-WS) ハンドラー・リストを作成します。

始める前に

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

ハンドラー・リストに追加できるのは、以前に構成されたハンドラーのみです。ハンドラーを構成するには、新規 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. 以下の一般プロパティーを入力します。
    名前
    ハンドラー・リストが認識される名前を入力します。
    この名前はすべてのセル有効範囲で固有である必要があり、以下の構文規則に従っている必要があります。
    • 「.」(ピリオド) で開始しないようにする必要があります。
    • スペースで開始または終了しないようにする必要があります。
    • ¥/ , # $ @ : ; " * ? < > | = + & % ' のいずれも含まないようにする必要があります。
    例えば、TestList です。
    説明
    ハンドラー・リストの説明 (オプション) を入力します。
    JAX-WS ハンドラー
    JAX-WS ハンドラー・ペインで、以下のステップを実行します。
    1. 使用可能な JAX-WS ハンドラーのリストから、1 つ以上のハンドラーを選択し、「追加」をクリックして、選択したハンドラーを、この JAX-WS ハンドラー・リスト用のハンドラーのリストに移動します。
    2. リスト内のハンドラーの位置を変更するには、この JAX-WS ハンドラー・リスト用のハンドラーのリストでハンドラーを選択してから、「上へ」または「下へ」をクリックします。
    ハンドラーは、ハンドラー・リストに表示される順に適用されます。
    注: 「リセット」をクリックすると、 「名前」フィールドと「説明」フィールドのみが、フォームが最初にロードされたときの状態にリセットされます。使用可能で割り当て済みのハンドラーの 2 つのリストは、リセットされません。
  5. 「OK」をクリックします。 この項目の一般プロパティーが保存されます。
  6. 変更をマスター構成に保存します。

タスクの結果

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

次のタスク

このハンドラー・リストをバージョン 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_new
ファイル名:tjwsn_jaxws_handler_list_new.html