6 WebLogic Server コ ンテナ用の
6 WebLogic Server コ ン テナ用の EJB のパ ッ ケージ化
6-2 WebLogic エ ン タ ープ ラ イズ JavaBeans プ ログラ マーズガ イ ド
1. EJB ソース フ ァ イル コ ンポーネン ト を見直し ま す。
2. EJB デプロ イ メ ン ト フ ァ イ ルを作成し ま す。
3. EJB デプロ イ メ ン ト 記述子を編集し ます。
4. デプ ロ イ メ ン ト モー ド を設定し ます。
5. EJB コ ンテナ ク ラ ス を生成し ます。
6. EJB を JAR または EAR フ ァ イ ルにパ ッ ケージ化し ま す。
7. WebLogic Server へ EJB ク ラ ス を ロー ド し ま す。
EJB コ ンポーネン ト ソース フ ァ イルの見直 し
エンテ ィ テ ィ Bean と セ ッ シ ョ ン Bean を実装するには、 以下の コ ンポーネン ト を使用し ます。
コ ンポーネン ト 説明
Bean ク ラ ス Bean ク ラ ス は、Bean のビ ジネ ス メ ソ ッ ド と ラ イ フ サ イ
ク ル メ ソ ッ ド を実装する 。 リ モー ト イ ン タ フ ェー
ス
リ モー ト イ ン タ フ ェース は、Bean の EJB コンテナに 入っ ていないアプ リ ケーシ ョ ンか ら ア ク セ ス可能な Bean のビ ジネ ス メ ソ ッ ド を定義する 。
リ モー ト ホーム イ ン タ フ ェース
リ モー ト ホーム イ ン タ フ ェース は、Bean の EJB コ ン テ ナに入っ ていないアプ リ ケーシ ョ ンか ら ア ク セ ス可能な Bean の ラ イ フサ イ ク ル メ ソ ッ ド を定義する 。
ローカル イ ン タ フ ェー ス
ローカルイ ン タ フ ェース は、 同じ EJB コ ン テナに入って い る 他の Bean が使用可能な Bean のビ ジネ スロ ジ ッ ク を 定義する 。
WebLogic Server の EJB デ プ ロ イ メ ン ト フ ァ イ ル
WebLogic Server の EJB デプロ イ メ ン ト フ ァ イル
EJB のデプロ イ メ ン ト 記述子要素を指定する には、 以下の WebLogic Server デプ ロ イ メ ン ト フ ァ イルを使用し ま す。
ejb-jar.xml
weblogic-ejb-jar.xml
weblogic-cmp-rdbms-jar.xml (省略可能、 CMP 専用 )
Bean を コ ンパイ ルする と 、 デプ ロ イ メ ン ト フ ァ イ ルは EJB デプ ロ イ メ ン ト の一
部 と な り ま す。 XML デプ ロ イ メ ン ト 記述子フ ァ イ ルには、 EJB に対するデプ ロ イ メ ン ト 記述子の最低限の設定を含め る必要があ り ます。 いっ たんフ ァ イルを作 成する と 、6-6 ページの 「EJB デプロ イ メ ン ト 記述子の指定 と 編集」 の手順に 従っ て後で編集で き ます。 デプ ロ イ メ ン ト 記述子フ ァ イ ルは、 使用する各フ ァ イ ルの文書型定義 (DTD) のバージ ョ ンに準拠する必要があ り ます。 フ ァ イ ルの文 書型定義 (DTD) には、 EJB XML デプロ イ メ ン ト 記述子フ ァ イ ルのすべての要素 および下位要素 ( 属性 ) の名前を記述し ます。 各フ ァ イ ルの説明については、 以 下の節を参照し て く だ さ い。
ロ ーカルホームイ ン タ フ ェース
ロ ーカルホーム イ ン タ フ ェースは、 同 じ EJB コ ン テナ に入っ てい る他の Bean が使用可能な Bean の ラ イ フサ イ
ク ル メ ソ ッ ド を定義する 。
主キー 主キーは、 デー タベース のポ イ ン タ を提供する 。 エン テ ィ テ ィ Bean だけが主キーを必要 と する 。
コ ンポーネン ト 説明
6 WebLogic Server コ ン テナ用の EJB のパ ッ ケージ化
6-4 WebLogic エ ン タ ープ ラ イズ JavaBeans プ ログラ マーズガ イ ド
ejb-jar.xml
ejb-jar.xmlフ ァ イルには、 Sun Microsystems 固有の EJB DTD が格納 さ れま す。 こ のフ ァ イ ルのデプ ロ イ メ ン ト 記述子は、 エン タープ ラ イ ズ Bean の構造を 記述し、 内部依存関係 と アプ リ ケーシ ョ ン アセンブ リ 情報を宣言し ます。 アプ
リ ケーシ ョ ン アセンブ リ 情報 と は、ejb-jarフ ァ イ ルのエン タープ ラ イ ズ Bean を アプ リ ケーシ ョ ン デプロ イ メ ン ト ユニ ッ ト と し てアセンブルする方法を記述 する も のです。 こ のフ ァ イ ルの要素の説明については、JavaSoft 仕様を参照し て
く だ さ い。
weblogic-ejb-jar.xml
weblogic-ejb-jar.xmlフ ァ イ ルには、 EJB の同時実行、 キ ャ ッ シ ング、 ク ラ ス タ化、 および動作を定義する WebLogic Server 固有の EJB DTD が格納 さ れま す。 また、 使用可能な WebLogic Server リ ソ ース を EJB にマ ッ プする記述子も格 納 さ れま す。 WebLogic Server リ ソ ースには、 セキ ュ リ テ ィ ロール名、 データ
ソ ース (JDBC プールや JMS 接続フ ァ ク ト リ な ど )、 およびデプ ロ イ済みの他の EJB があ り ます。 こ のフ ァ イ ルの要素の説明については、第 9 章
「weblogic-ejb-jar.xml 文書型定義」 を参照し て く だ さ い。
weblogic-cmp-rdbms.xml
weblogic-cmp-rdbms.xmlフ ァ イ ルには、 コ ンテナ管理に よ る永続性サービ ス を定義する WebLogic Server 固有の EJB DTD が格納 さ れま す。 こ のフ ァ イ ルを 使用し て、 コ ンテナがエンテ ィ テ ィ Bean の イ ン ス タ ン ス フ ィ ール ド と データ ベースのデータ と の同期を処理する方法を指定し ます。 こ のフ ァ イルの要素の説 明については、第 10 章 「weblogic-cmp-rdbms-jar.xml 文書型定義」 を参照し て く だ さ い。
WebLogic Server の EJB デ プ ロ イ メ ン ト フ ァ イ ル
デプロ イ メ ン ト フ ァ イル間の関係
weblogic-ejb-jar.xml 内の記述子は、ejb-jar.xml 内の EJB 名、 動作中の
WebLogic Server の リ ソ ース名、 および weblogic-cmp-rdbms-jar.xml (コ ンテ
ナ管理によ る永続性を使用する エンテ ィ テ ィ EJB の場合 ) 内に定義さ れてい る永 続性タ イ プ データに リ ン ク さ れています。 次の図は、 デプ ロ イ メ ン ト フ ァ イ ル
と WebLogic Server 間の関係を示し てい ます。
6 WebLogic Server コ ン テナ用の EJB のパ ッ ケージ化
6-6 WebLogic エ ン タ ープ ラ イズ JavaBeans プ ログラ マーズガ イ ド 図6-1 デプロイ メ ン ト フ ァ イルのコ ンポーネン ト 間の関係
EJB デプロ イ メ ン ト 記述子の指定と編集
以下のいずれかの方法で、 EJB デプロ イ メ ン ト 記述子を指定または編集し ます。
テキ ス ト エデ ィ タ を使用し て、 Bean のデプ ロ イ メ ン ト フ ァ イ ルを手動で編 集する。 デプ ロ イ メ ン ト フ ァ イルを手動で編集する方法については、6-7 ページの 「EJB デプ ロ イ メ ン ト 記述子の手動編集」 を参照し て く だ さ い。
WebLogic Server Administration Console の EJB デプ ロ イ メ ン ト 記述子エデ ィ タ を使用し て、 Bean のデプ ロ イ メ ン ト フ ァ イルを編集する。 デプロ イ メ ン
<security-role-assignment>. . .
<weblogic-enterprise-bean>
<ejb-name>. . .
<caching-descriptor>. . .
<clustering-descriptor>. . .
<resource-descriptor>. . .
<reference-descriptor>. . .
<persistence-descriptor>. . .
</ejb-name>
</weblogic-enterprise-bean>
weblogic-ejb-jar.xml
プ リ ン シパル JDBC プール JMS
<weblogic-rdbms-bean>
. . .
</weblogic-rdbms-bean>
weblogic-cmp-rdbms-jar.xml
<assembly-descriptor>
<security-role>. . .
</assembly-descriptor>
<entity>
<ejb-name>. . .
<ejb-ref>. . .
</entity>
ejb-jar.xml WebLogic Server
EJB
デ プ ロ イ メ ン ト フ ァ イ ルの作成 ト 記述子エデ ィ タの使用方法については、6-8 ページの 「EJB デプ ロ イ メ ン ト 記述子エデ ィ タの使用」 を参照し て く だ さ い。
WebLogic Server コ マン ド ラ イ ン ユーテ ィ リ テ ィ ツール、DDConverterを
使用し て、 EJB 1.1 デプ ロ イ メ ン ト 記述子を EJB 2.0 XML に変換する。
DDConverterツールの使用方法については、 8-26 ページの 「DDConverter」
を参照し て く だ さ い。
デプロ イ メ ン ト フ ァ イルの作成
各フ ァ イ ルの文書型定義 (DTD) のバージ ョ ンに準拠し た基本の XML デプロ イ メ ン ト フ ァ イルを EJB 用に作成し ます。 既存の EJB デプロ イ メ ン ト フ ァ イルをテ ンプレー ト と し て使用する こ と も、 WebLogic Server 配布キ ッ ト の EJB サンプル か ら コ ピーする こ と も でき ます。
SAMPLES_HOME\server\config\examples\applications
EJB デプロ イ メ ン ト 記述子の手動編集
XML デプ ロ イ メ ン ト 記述子要素を手動で編集するには、 次の手順に従います。
1. XML の形式の変更や、 フ ァ イルを無効にする可能性のあ る文字の挿入を行 わない ASCII テキス ト エデ ィ タ を使用し ます。
2. 編集する XML デプ ロ イ メ ン ト 記述子フ ァ イルを開き ま す。
3. 変更を入力し ま す。 使用し てい る オペレーテ ィ ング シ ス テムで大文字小文字 が区別さ れない場合であ っ て も、 フ ァ イ ル名やデ ィ レ ク ト リ 名の大文字小文 字は正確に指定し ます。
4. 省略可能な要素に対し てデフ ォル ト 値を使用する場合は、 要素の定義全体を 省略するか、 または次のよ う に空白値を指定し ます。
<max-beans-in-cache></max-beans-in-cache>
6 WebLogic Server コ ン テナ用の EJB のパ ッ ケージ化
6-8 WebLogic エ ン タ ープ ラ イズ JavaBeans プ ログラ マーズガ イ ド
EJB デプロ イ メ ン ト 記述子エデ ィ タの使用
WebLogic Server Administration Console で EJB デプ ロ イ メ ン ト 記述子を編集する には、 次の手順に従い ます。
1. WebLogic Server を起動し ます。
2. Administration Console を起動し て、 右ペイ ンの [デプロイメント] ノ ー ド を選
択し、 [EJB] を選択し ま す。
3. 展開さ れたデプ ロ イ 済み EJB の リ ス ト か ら、 編集し たい Bean を右 ク リ ッ ク し、 [EJB 記述子の編集] を選択し ま す。
4. EJB デプロ イ メ ン ト 記述子エデ ィ タが表示 さ れた ら、[ 永続化 ] ボ タ ン ま たは
[検証 ] ボ タ ン を ク リ ッ ク し ま す。
その EJB のデプロ イ メ ン ト 記述子フ ァ イ ルでの変更を保存し たい場合に は、 [ 永続化 ] を選択し ま す。
WebLogic Server で EJB のデプ ロ イ メ ン ト 記述子フ ァ イ ルの構造を検査
し、 XML フ ァ イルが正し く 解析で き る かを確認する場合には、 [ 検証 ] を選択し ま す。
5. 左ペイ ンで [EJB] を ク リ ッ ク し、 ノ ー ド を展開し ま す。
EJB デプロ イ メ ン ト 記述子フ ァ イ ルを表す以下の ノ ー ド が表示 さ れま す。
[ejb-jar] : こ の EJB の ejb-jar.xmlフ ァ イ ル デプ ロ イ メ ン ト 記述子を表 し ま す。
[webLogic-ejb-jar] : こ の EJB の weblogic-ejb-jar.xmlフ ァ イ ル デプ ロ イ メ ン ト 記述子を表し ま す。
[CMP] : こ の EJB の weblogic-cmp-rdbms-jar.xmlフ ァ イ ル デプ ロ イ メ ン ト 記述子を表し ま す。
6. 編集するデプ ロ イ メ ン ト 記述子の ノ ー ド を展開し ま す。
選択し た EJB の現在のデプロ イ メ ン ト 記述子が左ペイ ンに、 コ ン フ ィ グ レー シ ョ ン さ れている設定が右ペイ ンに表示 さ れます。 リ ス ト の項目を右ク リ ッ ク する と 、 その項目のダ イ ア ロ グ ウ ィ ン ド ウが右ペイ ンに表示 さ れます。
7. 丸を ク リ ッ ク する と 、 さ ま ざ ま な設定が右ペイ ンのダ イ ア ロ グ ウ ィ ン ド ウ に 表示さ れます。
他の EJB お よ び リ ソ ースへの参照 ダ イ ア ロ グ ウ ィ ン ド ウ の設定を変更する と 、 デプロ イ メ ン ト 記述子を編集で き ま す。
8. フ ォルダを ク リ ッ ク する と 、 設定を表示する テーブルが右ペイ ンに表示さ れ ます。
通常、 こ こ で新し い記述子を コ ン フ ィ グ レーシ ョ ン し た り 、 既存の設定を参 照し た り し ます。 下線が付いてい る表の項目を ク リ ッ クする と 、 設定を変更 する ためのダ イ ア ロ グが表示さ れます。
9. 右ペイ ンでデプ ロ イ メ ン ト 記述子の項目を右 ク リ ッ ク する と 、 記述子を削除 する こ と も でき ます。
注意: EJB デプ ロ イ メ ン ト 記述子の詳細については、 Administration Console の オン ラ イ ン ヘルプまたは第 9 章 「weblogic-ejb-jar.xml 文書型定義」 およ び第 10 章 「weblogic-cmp-rdbms-jar.xml 文書型定義」 を参照し て く だ さ い。
他の EJB および リ ソースへの参照
デプ ロ イ メ ン ト 記述子の EJB 参照を指定する こ と に よ り 、 EJB が WebLogic
Server にデプ ロ イ さ れてい る他の EJB をル ッ ク ア ッ プ し使用する こ と がで き ま
す。 EJB 参照を作成する際の要件は、 参照さ れ る EJB が呼び出し側の EJB に と っ て外部的か、 も し く は、 同じ アプ リ ケーシ ョ ン EAR フ ァ イルの一部 と し て デプ ロ イ さ れてい るかによ って異な り ま す。
外部 EJB の参照
外部 EJB を参照する ためには、 呼び出し側の EJB の weblogic-ejb-jar.xml フ ァ イ ルに <reference-descriptor>ス タ ンザを追加し ます。 次の XML コー ド に、 外部 EJB を参照する ス タ ンザの例を示し ます。
図6-2 外部 EJB を参照する XML コー ド例
<reference-descriptor>
<ejb-reference-description>
<ejb-ref-name>AdminBean</ejb-ref-name>
<jndi-name>payroll.AdminBean</jndi-name>