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

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

このタスクについて

「ハンドラー作成ウィザード (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 サービスをテストして、ハンドラーがトラフィックを 正しくインターセプトすることを検証します。
Icon that indicates the type of topic Task topic
Timestamp icon Last updated: last_date

File name: thandler.html