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