Avitek Medical Record 開発チュートリアル

MedRec アプリケーションの開発

チュートリアル 10 : EJBGen を使用した EJB デプロイメント記述子の生成

このチュートリアルでは、WebLogic Server EJBGen ユーティリティを使用して、プログラマが記述したメインの EJB Bean ソース ファイル (ビジネス ロジックを含むもの) から、デプロイメント記述子ファイル (ejb-jar.xml および weblogic-ejb-jar.xml) と、ホーム インタフェース ファイルなどの EJB ソース ファイルを生成する方法を例示します。特に、このチュートリアルでは physicianEar アプリケーションの PhysicianSession EJB を使用します。

EJBGen は Bean ファイルの中の JDK 5.0 メタデータ アノテーションを使用して、デプロイメント記述子ファイルと補助的な EJB Java ソース ファイル (ホーム インタフェースやリモート インタフェースなど) を生成します。つまり、ビジネス ロジックを含む 1 つのファイルをプログラミングし、このファイルの内部で EJBGen 固有のアノテーションを使用して EJB の形式や動作を指定するだけでよいのです。EJBGen ユーティリティによってすべてのサポート ファイルが生成されます。

wlcompile Ant タスクは、通常の *.java 拡張子ではなく *.ejb 拡張子を持つ Java ファイルがあると、自動的に EJBGen ユーティリティを呼び出します。したがって、EAR 構造の中に EJBGen のアノテーションを付けたファイルと標準の Java ファイルを混在させ、1 つの wlcompile Ant タスクを使用してすべてのコードをコンパイルすることができます。

MedRec アプリケーションの EJB ファイルには、すでに EJBGen メタデータ アノテーションが付いています。

このチュートリアルは、以下の節で構成されています。

前提条件

このチュートリアルを始める前に、「チュートリアル 9 : 開発環境の MedRec のデプロイ」を完了して、physicianEar アプリケーションのコンパイル、MedRec サーバの起動、EJB を含むアプリケーションのデプロイを済ませておきます。

チュートリアル 5 までを完了しているが、それ以降のチュートリアルを 1 つまたは複数行っていないため、physicianEar アプリケーションをまだデプロイしていない場合は、c:\medrec_tutorial\src\physicianEar サブディレクトリに移動し、環境を設定し、Ant を使用してデフォルトの build.xml ファイルを実行することでアプリケーション全体をビルドして WebLogic Server にデプロイすれば、追いつくことができます。

prompt> c:\bea\user_projects\domains\MedRecDomain\bin\setDomainEnv.cmd

prompt> cd c:\medrec_tutorial\src\physicianEar

prompt> ant -f build.xml build deploy.physician.ear

手順

以下の手順では、Administration Console を使用してデプロイ済み EJB の管理情報を表示し、EJBGen メタデータ アノテーションを含む EJB Java ソース ファイルを表示し、EJBGen が生成するファイルを表示して、最後に、EJBGen を使用してこれらのファイルを再生成します。

手順 1 : Administration Console を使用してデプロイ済み EJB の情報を表示する

この手順は EJBGen を使用するために必要ではありません。Administration Console を使用したデプロイ済み EJB の表示に関する追加情報としてのみ提供されています。

手順 2 : EJBGen メタデータ アノテーションを含む EJB Bean クラス ファイルを表示する

EJBGen に関する追加情報とアノテーションの完全なリストについては、「EJBGen リファレンス」を参照してください。

手順 3 : 生成済みのデプロイメント記述子ファイルと Java ファイルを表示する

「チュートリアル 7 : Ant タスクによる分割開発ディレクトリ アプリケーションのコンパイル」では、wlcompile Ant タスクを実行し、その中で、EJBGen ユーティリティを実行して physicianEar アプリケーションの EJB をコンパイルしました。この手順では、EJBGen によって生成され、\build ディレクトリに格納されているデプロイメント記述子ファイルと補助的な Java インタフェースを表示する方法について説明します。

手順 4: EJBGen ユーティリティを使用してデプロイメント記述子ファイルと EJB ファイルを再生成する

分割開発ディレクトリ構造内でアノテーションを使用して EJB をプログラミングする場合、通常、ソース ディレクトリ全体に対して wlcompile Ant タスクを実行するだけで、ビルド ディレクトリに EJB がコンパイルされ、そのサポート ファイルが生成されます。アノテーションを使用する EJB ファイルに *.ejb 拡張子が付いていれば、wlcompile Ant タスクは、そのファイルに対して EJBGen Ant タスクを実行することを自動的に認識します。

ただし、wlcompile Ant タスクとは別に、EJB デプロイメント記述子と補助的なホームおよびリモート インタフェースを個別に生成する場合は、EJBGen ユーティリティを単独で使用することもできます。EJBGen ユーティリティは以下のいずれかの方法で実行できます。

以下の手順では Ant タスクの使用方法を示します。

ベスト プラクティス

アプリケーションの EJB コンポーネントの開発には EJBGen を使用します。EJB の開発とコード メンテナンスを簡素化するには、Bean の実装ファイルのみを記述して EJBGen メタデータ アノテーションを付け、その後に EJBGen を使用して残りのすべてのファイル (ホーム インタフェース、ローカル インタフェース、デプロイメント記述子ファイル) を生成します。

全体像

MedRec をコンパイルしてデプロイするスクリプトは、EJBGen を使用してアプリケーションのほとんどの EJB ファイルを生成します。wlcompile が *.ejb 拡張子の付くファイルを処理するときに、EJBGen タスクが wlcompile タスクによって暗黙的に呼び出されます。

PhysicianSessionEJB.ejb Java ファイルには、EJBGen が EJB 記述子ファイルとホーム インタフェースを生成するために必要なすべての情報が含まれています。EJBGen のアノテーションを参照するには、C:\medrec_tutorial\src\physicianEar\physSessionEjbs\com\bea\medrec\controller\PhysicianSessionEJB.ejb を IDE またはテキスト エディタで開きます。

たとえば、以下のクラス レベルの @Session アノテーションでは、クラスがステートレス セッション EJB を実装することを指定し、プールとタイムアウトの設定を定義しています。この設定は生成される weblogic-ejb-jar.xml に含まれます。

@Session(maxBeansInFreePool = "1000",
         initialBeansInFreePool = "0",
         transTimeoutSeconds = "0",
         type = Session.SessionType.STATELESS,
         defaultTransaction = Constants.TransactionAttribute.REQUIRED,
         enableCallByReference = Constants.Bool.TRUE,
         ejbName = "PhysicianSessionEJB")
public class PhysicianSessionEJB extends GenericSessionBean {

...

トラブルシューティング

RecordEJB エンティティ Bean は、PointBase データベースにハードコード化されています。したがって、Medrec アプリケーションで Pointbase 以外のデータベース (Oracle、MySQL など) を使用する場合は、JDBC データ ソース (グローバル スコープおよびアプリケーション スコープの両方) が新しいデータベースを指すように変更するだけでなく、新しいデータベースに合わせて RecordEJB エンティティ Bean のソース コードを変更する必要があります。

RecordEJB エンティティ Bean のソース コードは、次の EJBGen ファイルに含まれています。

C:\medrec_tutorial\src\medrecEar\entityEjbs\com\bea\medrec\entities\RecordEJB.ejb

Pointbase データベースの使用は、@Entity メタデータ アノテーションの databaseType 属性によってハードコード化されています。次のコードの抜粋では、該当箇所が太字で示されています。

@Entity(maxBeansInCache = "1000",
        dataSourceName = "jdbc/MedRecTxDataSource",
        transTimeoutSeconds = "0",
        ejbName = "RecordEJB",
        reentrant = Constants.Bool.FALSE,
        concurrencyStrategy = Constants.ConcurrencyStrategy.DATABASE,
        delayDatabaseInsertUntil = Entity.DelayDatabaseInsertUntil.EJB_POST_CREATE,
        tableName = "record",
        readTimeoutSeconds = "600",
        primKeyClass = "java.lang.Integer",
        defaultTransaction = Constants.TransactionAttribute.MANDATORY,
        abstractSchemaName = "RecordEJB",
        databaseType = Entity.DatabaseType.POINTBASE)

たとえば、Oracle データベースを指定するには、databaseType 属性の値を Entity.DatabaseType.ORACLE に変更します。

databaseType 属性の有効な値については、「weblogic.ejbgen.Entity」を参照してください。

関連情報