JAX-WS Web サービス・ハンドラーの作成と編集

JAX-WS 論理ハンドラーまたはプロトコル・ハンドラーを追加して、 Web サービスおよびそのクライアントへのインバウンド・メッセージとアウトバウンド・メッセージを傍受することができます。 現在使用可能な JAX-WS Web サービスおよびクライアントから選択して、 「ハンドラー作成ウィザード (Handler Creation Wizard)」ダイアログを起動することができます。 このダイアログで、ハンドラーのクラス名、ハンドラー名、およびオプションの表示名を 入力したり、ハンドラーのタイプ (論理またはプロトコル) を指定できます。 終了すると、ウィザードはスケルトン・ハンドラー・コードを生成し、 適用可能なデプロイメント記述子を更新します。

このタスクについて

「ハンドラー作成ウィザード (Handler Creation Wizard)」は以下の点で役立ちます。

サービス・サイド・ハンドラーの追加または編集

手順

  1. 「サービス」ビューを開きます。
  2. JAX-WS ツリーから、Web サービスを選択します。右クリックして、 「JAX-WS Web サービス・ハンドラーの構成」を選択します。
  3. そのサービスに対して既にハンドラーが定義されている場合、そのハンドラーを 削除または再配列することができます。また、「新規」をクリックして新規ハンドラーを追加することもできます。
    1. 新規ハンドラー・クラスを作成するか、それとも既存のものを選択するかを選択します。
    2. ハンドラーの完全修飾クラス名を入力または参照します。
    3. ハンドラーの名前を入力します。
    4. ハンドラーの表示名を入力します (オプション)。
    5. ハンドラー・タイプとして論理またはプロトコルを選択します。
    6. ハンドラーの出力フォルダーがリストされます。デフォルトでは、 これはサービス用の src フォルダーです。

クライアント・サイド・ハンドラーの追加

このタスクについて

手順

  1. 「サービス」ビューを開きます。
  2. JAX-WS ツリーから、Web サービス・クライアントを選択します。右クリックして、 「JAX-WS クライアント・ハンドラーの構成」を選択します。
  3. そのクライアントに対して既にハンドラーが定義されている場合、そのハンドラーを 削除または再配列することができます。また、「新規」をクリックして新規ハンドラーを追加することもできます。
    1. ハンドラーの完全修飾クラス名を参照します。
    2. ハンドラーの名前を入力します。
    3. ハンドラーの表示名を入力します (オプション)。
    4. ハンドラー・タイプとして論理またはプロトコルを選択します。
    5. ハンドラーの出力フォルダーがリストされます。デフォルトでは、 これはクライアント用の src フォルダーです。

Web サービス・ハンドラーのテスト

手順

  1. 生成されたハンドラー・クラスを変更します (例えば、println を追加)。
  2. Web サービス・クライアント・サンプル JSP を起動し、Web サービスをテストします。 ハンドラーがトラフィックを正常に傍受します。

フィードバック