メディエーション・ハンドラーを作成し、そこにメディエーション機能を追加して、アプリケーション・サーバーにインストールするための準備を行えます。
始める前に
Java™ プログラミング
環境へのアクセス権限およびアセンブリー・ツール (
IBM® Rational® Application Developer など) が必要です。
このタスクについて
メディエーション・ハンドラーがデプロイできます。各メディエーション・ハンドラーは、実行時に何らかの特定のメッセージ処理 (メッセージ・フォーマットの変換や
特定の宛先へのメッセージのルーティングなど) を実行します。
メディエーション・ハンドラーは、Java プログラム・フレームワークです。これに、メディエーション機能を実行するコードを追加します。
メディエーション・ハンドラー・クラスは、Java プロジェクト、または EJB プロジェクト (デプロイメント成果物用に必要) のどちらかに定義できます。プログラミング成果物とデプロイメント成果物を
別々のプロジェクトに分けて入れることができます。以下のステップは EJB プロジェクト用ですが、Java プロジェクトを作成する場合もほとんど同じステップになります。この理由は、Java プロジェクトまたは EJB プロジェクトのいずれかのターゲット・サーバーを定義すると、そのサーバーのランタイム・プラグインによってクラスパスが正しく設定されるためです。
手順
- 新規 EJB プロジェクトを作成します。
- Java EE プロジェクトについての作業を行うため、Java EE パースペクティブに切り替えます。
「ウィンドウ」>「パースペクティブを開く」>「その他」>「Java EE」をクリックします。
- 「ファイル」メニューから、「新規」>「プロジェクト」を選択します。
- Java EE フォルダーを展開し、エンタープライズ・アプリケーション・プロジェクトを
選択します。「次へ」をクリックします。
- オプション: EJB プロジェクトでなく Java プロジェクトを作成した場合は、コンテキスト・メニューの Java プロジェクト・フォルダー・アイコンを右クリックし、「プロパティー」を選択します。「プロパティー」パネルが表示されたら、「サーバー」プロパティーを選択し、次のステップに従って、システムの該当するサーバーをプロジェクトの対象にします。
- プロジェクトの名前を入力し、プロジェクトの対象をシステムの該当サーバーにします。(このサーバーを対象にするのが初めての場合は、
「新規作成...」をクリックします。)「次へ」をクリックして、「EAR Module Projects」ウィンドウに移動します。
- 「New Module...」をクリックします。
- EJB プロジェクトのチェック・ボックスを選択し、メディエーション・ハンドラーの名前を入力することによって、新規モジュール・プロジェクトを作成します。
- 「終了」をクリックします。 「EAR Module Projects」ウィンドウに戻ります。
- 「終了」をクリックして、新規プロジェクトを作成します。
- com.ibm.websphere.sib.mediation.handler.MediationHandler インターフェースを実装することによって、メディエーション・ハンドラー・クラスを作成します。
- 「ファイル」メニューから、「新規」>「Java クラス」を選択します。
- メディエーション EAR プロジェクトのソース・フォルダーを指定します。
- メディエーション・ハンドラーの名前を指定します。
- スーパークラス「java.lang.Object」を選択します。
- インターフェース「com.ibm.websphere.sib.mediation.handler.MediationHandler」を選択します。
- 「継承された抽象メソッド (Inherited abstract methods)」チェック・ボックスを選択します。
- 「終了」をクリックして、新規メディエーション・ハンドラー・クラスを作成します。
- IBM Rational Application Developer を使用して、メッセージをメディエーション・ハンドラーに変換または経路指定するファンクション・コードを追加します。詳しくは、メディエーション機能のハンドラー・コードへの追加を参照してください。
ツールキットによって作成されるハンドル・メソッドのデフォルトの戻り値は false です。これは、メッセージを破棄することに注意してください。
メッセージを保存するには、戻り値を true に変更する必要があります。
- メディエーション・ハンドラー・クラスから EAR ファイルを生成します。IBM Rational Application Developer の資料に記載されている指示に従ってください。
次のタスク
これで、メディエーション・ハンドラーを含む EAR ファイルをアプリケーション・サーバーにインストールする準備ができました。