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

このチュートリアルでは、wlcompile Ant タスクを使用してエンタープライズアプリケーションのソースファイルをコンパイルする方法を説明します。wlcompile は WebLogic 分割開発ディレクトリ構造を使用して、コンパイル済みの Java クラスが格納されるビルドまたは出力ディレクトリを生成します。ビルドディレクトリと「チュートリアル 6 : WebLogic Server の分割ディレクトリ構造について」で説明されるソースディレクトリで、WebLogic Server のデプロイ可能なアプリケーションが構成されます。

分割開発ディレクトリを使用して以下のようなアプリケーションビルドタスクを実行するその他の WebLogic Server Ant タスクの使用方法については、後続のチュートリアルで説明します。

前提条件

このチュートリアルを始める前に、以下のことを行ってください。

medrec_tutorial.zip ファイルを復元した後で \build ディレクトリの内容を見ると、MedRec アプリケーションを構成する多くのクラスがすでにビルドされていることがわかります。\medrecEar および \startBrowserEar アプリケーションのすべてのクラスや、\physicianEar アプリケーションの Web サービスなどです。このチュートリアルでは、wlcompile Ant タスクを使用して、まだコンパイルされていない physicianEar アプリケーションのクラス (EJB や Web サービス関連) をコンパイルする方法について説明します。ビルド済みのクラスは、再コンパイルすることもできます。

手順

MedRec アプリケーションスイートで分割開発ディレクトリと共に wlcompile タスクを使用するには、次の手順に従います。

手順 1 : build.xml ファイルを作成する

WebLogic 分割開発ディレクトリ構造を使用してソースファイルを格納すると、アプリケーションのコンパイルに必要な build.xml ファイルを簡略化できます。ほとんどのエンタープライズアプリケーションの場合、すべてのモジュールをコンパイルするのに数行の簡単なスクリプトで十分です。wlcompile タスクにより、アプリケーションで使用されるモジュールが自動的に判断され、それに従ってクラスパスの依存関係が維持されるからです。

wlcompile のしくみを理解するために、簡単な XML ファイルを作成して Physician アプリケーションをコンパイルします。まず MedRec プロジェクトディレクトリ内の physicianEar サブディレクトリに移動します。

prompt> cd c:\medrec_tutorial\src\physicianEar

physicianEar の最上位には、エンタープライズアプリケーションを構成する Web アプリケーション、EJB、および Web サービスコンポーネントのサブディレクトリが含まれます。XML ファイルもこの場所に格納します。

テキストエディタを使用して、physicianEar ディレクトリに新しい mybuild.xml ファイルを作成します。

prompt> notepad mybuild.xml

注意: build.xml ファイルを手動で入力したくない場合は、wlcompile_tutorial.xml ファイル (c:\medrec_tutorial\src\physicianEar 内) をコピーして、新しいファイル名 mybuild.xml にします。その上で、以降の手順でこのファイルの内容を理解してください。

mybuild.xml ファイルで、まず tutorial という名前のプロジェクトを定義します。

<project name="tutorial" default="build">

アプリケーションをビルドするメインターゲットを定義します。このターゲット (名前は build) は、非常に単純です。wlcompile タスクを使用して、ソースディレクトリ (分割開発ディレクトリ構造を使用) およびコンパイルされたファイルを格納する出力ディレクトリを指定します。次の行を入力します。

  <target name="build">
    <wlcompile srcdir="c:/medrec_tutorial/src/physicianEar"
               destdir="c:/medrec_tutorial/build/physicianEar">
         <ejbgen source="1.5" />
    </wlcompile>
  </target>

単純なエンタープライズアプリケーションで必要なことは、多くの場合、wlcompile でコンパイル用に使用するソースディレクトリとビルドディレクトリを指定することだけです。srcdir ディレクトリと destdir ディレクトリが必ず別々の場所を指すようにしてください。開発プロセス中はソースファイルと出力ファイルが別々に格納されるようにする必要があります。

ejbgen Ant タスクでは、EJBGen コマンドが *.ejb ファイルを処理するときに使用する JDK のバージョンを指定します。MedRec の EJB は新しい JDK 5.0 メタデータアノテーション機能を使用しているため、version 属性を 1.5 (JDK の 5.0 バージョンと同じ) に設定してください。

mybuild.xml ファイルを完成するには、次の行を追加してプロジェクトを閉じます。

</project>

完成したファイルは次のようになっている必要があります。すべてのテキストを入力する代わりに、wlcompile_tutorial.xml をコピーすることもできます。

<project name="tutorial" default="build">

  <target name="build">
    <wlcompile srcdir="c:/medrec_tutorial/src/physicianEar"
               destdir="c:/medrec_tutorial/build/physicianEar">
         <ejbgen source="1.5" />
    </wlcompile>
  </target>

</project>

手順 2 : アプリケーションをコンパイルする

mybuild.xml ファイルを作成したら、これを使用してアプリケーションをコンパイルできます。

次のように MedRecDomain 環境スクリプトを使用して環境を設定済みであることを確認します。

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

physicianEar ディレクトリに移動し、ant コマンドを使用して mybuild.xml スクリプトを実行してコンパイルします。

prompt> cd c:\medrec_tutorial\src\physicianEar

prompt> ant -f mybuild.xml

ビルドスクリプトに情報メッセージを追加しなかった場合でも、wlcompile タスクにより、進捗状況を示す独自の出力が表示されます。

Buildfile: mybuild.xml

build:
    [javac] Compiling 1 source file to C:\medrec_tutorial\build\physicianEar\APP-INF\classes
   [ejbgen] EJBGen WebLogic Server 9.2 SP0  Fri Jun 23 20:47:26 EDT 2006 783464

   [ejbgen]  Creating C:\medrec_tutorial\build\physicianEar\physSessionEjbs\com\bea\medrec\controller\PhysicianSessionHome.java
   [ejbgen]  Creating C:\medrec_tutorial\build\physicianEar\physSessionEjbs\com\bea\medrec\controller\PhysicianSession.java
   [ejbgen]  Creating C:\medrec_tutorial\build\physicianEar\physSessionEjbs\\ejb-jar.xml
   [ejbgen]  Creating C:\medrec_tutorial\build\physicianEar\physSessionEjbs\\weblogic-ejb-jar.xml
     [move] Moving 2 files to C:\medrec_tutorial\build\physicianEar\physSessionEjbs\META-INF
    [javac] Compiling 3 source files to C:\medrec_tutorial\build\physicianEar\physSessionEjbs
[wlcompile] Note: C:\medrec_tutorial\build\physicianEar\physSessionEjbs\com\bea\medrec\controller\PhysicianSessionEJB.java uses or overrides a deprecated API.
[wlcompile] Note: Recompile with -Xlint:deprecation for details.
    [javac] Compiling 12 source files to C:\medrec_tutorial\build\physicianEar\physicianWebApp\WEB-INF\classes

BUILD SUCCESSFUL

Total time: 10 seconds

上記の出力が表示されなかった場合や、問題が発生した場合には、代わりに、このチュートリアルで提供されている Ant ビルドファイルを使用できます。

prompt> ant -f wlcompile_tutorial.xml

手順 3 : 出力ファイルを検査する

physicianEar をコンパイルしたので、ここでビルドディレクトリがどのようになっているかを確認します。ビルドターゲットのすべての出力は、エンタープライズアプリケーションの出力ディレクトリ c:\medrec_tutorial\build\physicianEar にあります。

wlcompile の出力は、ビルドがまず、Physician アプリケーションのセッション EJB の ejbgen を実行したことを示しています。デプロイメント記述子が作成されたことを確認してください。

また、wlcompile Ant タスクで実際の EJB クラスもコンパイルされ、physSessionEjbs ディレクトリにコピーされています。

wlcompile により Web アプリケーションのサーブレットクラスがコンパイルされ、WEB-INF\classes ディレクトリに置かれています。

actions ディレクトリには Struts アクションクラスが格納されます。

エンタープライズアプリケーションのビルドディレクトリ (c:\medrec_tutorial\build\physicianEar) 全体には、EJB および Web サービスコンポーネントのみのデプロイメント記述子ファイルが含まれています。これは、EJB 記述子と Web サービス記述子が、それぞれ ejbgen と Java Web サービス (JWS) アノテーションを使用して生成されるためです (Web サービスは .zip ファイルの一部としてあらかじめコンパイルされています)。ビルドスクリプトを再び実行して、EJB および Web サービスデプロイメント記述子を含むビルドディレクトリの内容全体を再作成できます。

エンタープライズアプリケーションおよび Web アプリケーションのデプロイメント記述子 (application.xml、weblogic-application.xml、web.xml、および weblogic.xml) は、手動で作成および編集されるためソースディレクトリに残っています。これらは簡単に置き換えたり再ビルドしたりすることはできません。

ベストプラクティス

より複雑なエンタープライズアプリケーションでは、wlcompile タスクで自動的に処理できないコンパイルの依存関係がある場合があります。ただし、wlcompile で include および exclude オプションを使用して独自の依存関係を強制できます。include および exclude オプションはエンタープライズアプリケーションのモジュール名 (エンタープライズアプリケーションのソースディレクトリ内のサブディレクトリ名) を受けて、これらをコンパイル処理に含めたり除外したりします。例については、「全体像」を参照してください。

全体像

MedRec エンタープライズアプリケーションでは WebLogic 分割開発ディレクトリ構造を使用し、ビルドスクリプトで wlcompile タスクを使用しますが、デフォルトの wlcompile タスクで処理されない特定の依存関係があります。たとえば、build.xml ファイルの次のようなサンプルを見てみましょう。

ビルドスクリプトがまず、エンタープライズアプリケーションの adminWebApp、xml、mdbEjbs、および webServicesEjb を除くすべてのモジュールをコンパイルすることがわかります。コンパイルされないこれらのモジュールは、ソースディレクトリ内のサブディレクトリ名に対応しています。

続いて、アプリケーションの xml および webServicesEjb モジュールだけがコンパイルされます。

また、コンパイルの前に、wlcompile Ant タスクは、build/earName/APP-INF/lib および build/earName/APP-INF/classes の両方の内容を CLASSPATH に追加することに注意してください。

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