メディエーション・ハンドラーの作成

メディエーション・ハンドラーを作成し、そこにメディエーション機能を追加して、アプリケーション・サーバーにインストールするための準備を行えます。

始める前に

Java™ プログラミング 環境へのアクセス権限およびアセンブリー・ツール (IBM® Rational® Application Developer など) が必要です。

このタスクについて

メディエーション・ハンドラーがデプロイできます。各メディエーション・ハンドラーは、実行時に何らかの特定のメッセージ処理 (メッセージ・フォーマットの変換や 特定の宛先へのメッセージのルーティングなど) を実行します。 メディエーション・ハンドラーは、Java プログラム・フレームワークです。これに、メディエーション機能を実行するコードを追加します。

メディエーション・ハンドラー・クラスは、Java プロジェクト、または EJB プロジェクト (デプロイメント成果物用に必要) のどちらかに定義できます。プログラミング成果物とデプロイメント成果物を 別々のプロジェクトに分けて入れることができます。以下のステップは EJB プロジェクト用ですが、Java プロジェクトを作成する場合もほとんど同じステップになります。この理由は、Java プロジェクトまたは EJB プロジェクトのいずれかのターゲット・サーバーを定義すると、そのサーバーのランタイム・プラグインによってクラスパスが正しく設定されるためです。

手順

  1. 新規 EJB プロジェクトを作成します。
    1. Java EE プロジェクトについての作業を行うため、Java EE パースペクティブに切り替えます。 「ウィンドウ」>「パースペクティブを開く」>「その他」>「Java EE」をクリックします。
    2. 「ファイル」メニューから、「新規」>「プロジェクト」を選択します。
    3. Java EE フォルダーを展開し、エンタープライズ・アプリケーション・プロジェクトを 選択します。「次へ」をクリックします。
    4. オプション: EJB プロジェクトでなく Java プロジェクトを作成した場合は、コンテキスト・メニューの Java プロジェクト・フォルダー・アイコンを右クリックし、「プロパティー」を選択します。「プロパティー」パネルが表示されたら、「サーバー」プロパティーを選択し、次のステップに従って、システムの該当するサーバーをプロジェクトの対象にします。
    5. プロジェクトの名前を入力し、プロジェクトの対象をシステムの該当サーバーにします。(このサーバーを対象にするのが初めての場合は、 「新規作成...」をクリックします。)「次へ」をクリックして、「EAR Module Projects」ウィンドウに移動します。
    6. 「New Module...」をクリックします。
    7. EJB プロジェクトのチェック・ボックスを選択し、メディエーション・ハンドラーの名前を入力することによって、新規モジュール・プロジェクトを作成します。
    8. 「終了」をクリックします。EAR Module Projects」ウィンドウに戻ります。
    9. 「終了」をクリックして、新規プロジェクトを作成します。
  2. com.ibm.websphere.sib.mediation.handler.MediationHandler インターフェースを実装することによって、メディエーション・ハンドラー・クラスを作成します。
    1. 「ファイル」メニューから、「新規」>「Java クラス」を選択します。
    2. メディエーション EAR プロジェクトのソース・フォルダーを指定します。
    3. メディエーション・ハンドラーの名前を指定します。
    4. スーパークラス「java.lang.Object」を選択します。
    5. インターフェース「com.ibm.websphere.sib.mediation.handler.MediationHandler」を選択します。
    6. 「継承された抽象メソッド (Inherited abstract methods)」チェック・ボックスを選択します。
    7. 「終了」をクリックして、新規メディエーション・ハンドラー・クラスを作成します。
  3. IBM Rational Application Developer を使用して、メッセージをメディエーション・ハンドラーに変換または経路指定するファンクション・コードを追加します。詳しくは、メディエーション機能のハンドラー・コードへの追加を参照してください。 ツールキットによって作成されるハンドル・メソッドのデフォルトの戻り値は false です。これは、メッセージを破棄することに注意してください。 メッセージを保存するには、戻り値を true に変更する必要があります。
  4. メディエーション・ハンドラー・クラスから EAR ファイルを生成します。IBM Rational Application Developer の資料に記載されている指示に従ってください。

次のタスク

これで、メディエーション・ハンドラーを含む EAR ファイルをアプリケーション・サーバーにインストールする準備ができました。

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



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