仲介ハンドラーの作成

このタスクを使用して、アセンブリー・ツールキットを使用して仲介ハンドラーを作成します。

このタスクでは、仲介の仲介ハンドラー・クラスが入っている EJB モジュールがあることを前提としています。 詳しくは、EJB モジュールの作成を参照してください。 仲介ハンドラー・クラスの作成について詳しくは、「サービス統合 (Service Integration)」の情報を参照してください。
このタスクでは、仲介ハンドラー・エンタープライズ Bean のデプロイメント記述子ファイルを編集し、WebSphere Application Server にエクスポートできる EAR ファイルとして保管します。

アセンブリー・ツールキットを使用して、次の手順を実行してください。

  1. EJB モジュールを表示する。
    1. 「J2EE パースペクティブ」に切り替えて、J2EE プロジェクトを処理する。 「ウィンドウ」 > 「パースペクティブを開く」 > 「その他」 >「J2EE」の順にクリックしてください。
    2. 「プロジェクト・エクスプローラー」ビューで、「EJB モジュール」を展開して、EJB プロジェクトが入っているフォルダーを表示する。
    3. そのフォルダーを展開し、プロジェクトをダブルクリックする。
    EJB デプロイメント記述子エディターに、EJB プロジェクトが表示されます。
  2. エディター・エリアの下部にある「仲介ハンドラー」タブを選択して、「仲介ハンドラー」ペインを開く。
  3. 「追加」をクリックして、「仲介ハンドラーの定義」ペインを開く。
  4. 仲介ハンドラーの次のプロパティーを指定する。
    名前
    仲介ハンドラーの名前を入力します。 この名前は、WebSphere Application Server 管理セル内で固有のものでなければなりません。
    説明
    オプション: 仲介に対して指定されるプロパティーを考慮して、仲介の説明を入力します。
    ハンドラー・クラス
    「ハンドラー・クラス」フィールドの隣にある「参照」をクリックして、仲介ハンドラー・クラスのリストを表示します。 仲介の仲介ハンドラー・クラスを選択してください。
    必要に応じて、パラメーター・リストにパラメーター名が自動的に入力されます。
  5. 任意: 実行時に仲介の振る舞いを制御するのに使用したいパラメーターを選択する。デフォルトでは、すべてのパラメーターが選択されています。
  6. 任意: 独自のハンドラー・リスト内で仲介ハンドラーを作成したい場合は、「終了」をクリックする。 デフォルトでは、仲介ハンドラーと同じ名前を使用して、ハンドラー・リストが作成されます。
  7. 任意: ハンドラー・リストの拡張オプションを指定したい場合は、「拡張を表示」をクリックしてから、「ハンドラー・リスト包含を定義」チェック・ボックスを選択する。 これで、「ハンドラー・リスト包含」ペインが表示されます。次のプロパティーを指定し、「追加」をクリックしてから、「終了」をクリックして、ハンドラー・リストに仲介ハンドラーを追加してください。
    ハンドラー・リスト名
    リスト・ボックス内で既存のハンドラー・リストの名前を選択するか、新しい名前を入力します。
    ハンドラー・リストの説明
    オプション: ハンドラー・リストの情報の説明を入力します。
    シーケンス番号
    ハンドラー・リスト内における仲介ハンドラーの位置を指定します。 デフォルトでは、仲介ハンドラーは、ハンドラー・リスト内の先頭位置 (シーケンス番号 0) に追加されます。 実行時に、仲介ハンドラーは、シーケンス番号順にメッセージに適用されます。 最低のシーケンス番号を持つ仲介ハンドラーが、最初に適用されます。
  8. 仲介ハンドラーに、非プリミティブ・タイプのプロパティーがある場合、それらのプロパティーは、「非プリミティブ・プロパティー」ページに表示されます。 表示されるプロパティーごとに、「デプロイメント・エントリー・タイプ」リスト・ボックス内で作成する参照エントリーのタイプを選択してから、「終了」をクリックしてください。
  9. 「仲介ハンドラー」ペインに、仲介ハンドラーが表示されます。 定義したプロパティーおよびパラメーターを表示または変更することができます。 ハンドラー・リスト、仲介パラメーター、または参照パラメーターの変更について詳しくは、デプロイメント情報の変更を参照してください。
  10. 「ファイル」 > 「保管」の順に選択して、仲介ハンドラーを EAR ファイルとして保管する。
これで、この EAR ファイルを WebSphere Application Server にエクスポートする準備が完了しました。
関連概念
仲介ハンドラー
ご利用条件 | フィードバック
(C) Copyright IBM Corporation 2000, 2004. All Rights Reserved. (C) Copyright IBM Japan 2005.