新規 JAX-RPC ハンドラー構成の作成

サービス統合バスがデプロイされた Web サービスでハンドラー・リストの一部として使用できるよう、 JAX-RPC ハンドラー構成を作成します。ハンドラーはポートでメッセージをモニターして、各メ ッセージの送信者と内容に応じて適切な処置を取ります。

始める前に

このタスクは、既にハンドラーを作成していることを前提としています。 これは、IBM® Rational® Application Developer または同様のツールを使用して実行できます。 詳しくは、IBM developerWorks® の記事 Support for J2EE Web Services in WebSphere® Studio Application Developer V5.1 -- Part 3: JAX-RPC Handlers を参照してください。

JAX-RPC ハンドラー・クラスのロードで説明されるように、監視するサービスのポートをホストするサーバーまたはクラスターがハンドラー・クラスを使用できるようにする必要があります。

このタスクについて

Java™ API for XML-based remote procedure call (JAX-RPC) ハンドラーは、一定範囲の処理タスク を実行する Java クラスです。 例えば、メッセージのロギング、コンテンツの変換、着信要求の終了などを実行します。 WebSphere Application Server がハンドラーを認識するようにし、またハンドラーが 1 つ以上のハンドラー・リストに包含されることを可能にするには、管理コンソールを使用して、新しいハンドラー構成を作成します。

手順

  1. ナビゲーション・ペインで、「サービス統合 ->「Web サービス」 ->「JAX-RPC ハンドラー」」をクリックします。 JAX-RPC ハンドラー・コレクション・フォームが表示されます。
  2. 「新規」をクリックします。 JAX-RPC ハンドラー設定フォームが表示されます。
  3. 以下の一般プロパティーを入力します。
    名前
    ハンドラーが認識される名前を入力します。
    この名前は固有である必要があり、以下の 構文規則に従っている必要があります。
    • 「.」(ピリオド) で開始しないようにする必要があります。
    • スペースで開始または終了しないようにする必要があります。
    • ¥/ , # $ @ : ; " * ? < > | = + & % ' のいずれも含まないようにする必要があります。
    例えば、TestHandler です。
    説明
    ハンドラーの説明 (オプション) を入力します。
    クラス名
    インスタンス化するクラス名を入力します。例えば、com.ibm.jaxrpc.handler.TestHandler です。
    注: 別々のハンドラー名を持つ個々のインスタンスを作成して同じハンドラークラスに指定することにより、ハンドラーの複数インスタンスを構成できます。
  4. 「OK」をクリックします。 この項目の一般プロパティーが保存され、 追加プロパティー・オプションが使用できるようになります。
  5. 以下の追加プロパティーを入力します。
    SOAP ロール
    このハンドラーが果たす SOAP ロールのリストに、SOAP アクター定義を追加します。 詳しくは、 SOAP 仕様を参照してください。
    JAX-RPC ヘッダー
    このハンドラーが動作を制御する JAX-RPC ヘッダーのリストに、 JAX-RPC ヘッダー定義 (名前空間 URI とローカル・パート) を追加します。 JAX-RPC ヘッダーとは、JAX-RPC ハンドラーで処理される SOAP ヘッダーのことです。
    カスタム・プロパティー
    カスタム・プロパティー (名前と値のペア。 名前はプロパティー・キー、値は内部システム構成プロパティーの設定に使用できるストリング値) を追加します。
  6. 変更をマスター構成に保存します。

タスクの結果

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

次のタスク

このハンドラーを使用するには、これをハンドラー・リストに追加します。 新規 JAX-RPC ハンドラー・リストの作成、または既存の JAX-RPC ハンドラー・リストの変更を参照してください。

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



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