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

medrec_tutorial プロジェクトディレクトリ内のいくつかのサブディレクトリ (medrecEar、physicianEar、startBrowserEar) では、ソースファイルの格納に WebLogic Server 分割開発ディレクトリ構造が使用されます。分割開発ディレクトリは、CLASSPATH の依存関係を自動的に維持しながら、エンタープライズアプリケーションファイルのビルド、デプロイ、パッケージ化を簡単に行えるディレクトリレイアウトと補助的な Ant タスクで構成されます。ソースファイルと編集可能なデプロイメント記述子を含むディレクトリと、コンパイルされたクラスファイルと生成されたデプロイメント記述子が保存されるディレクトリが異なるため、ディレクトリ構造が分割されています。

分割開発ディレクトリ構造は、独自のアプリケーション開発に使用する重要なツールです。ソースファイルと生成されたファイルが別々に保存されるため、開発プロジェクトとソース制御システムを簡単に統合できます。分割開発ディレクトリでは、アプリケーションのデプロイも簡単に行えます。最初にファイルをコピーしてアプリケーションをステージングする必要はありません。アプリケーションをデプロイするときに、自動的にビルドディレクトリとソースディレクトリの両方の内容が使用されます。

このチュートリアルでは、MedRec アプリケーションスイートで使用されるソースディレクトリ構造のレイアウトと機能について説明します。次のチュートリアルでは、wlcompile タスクを使用してエンタープライズアプリケーションをコンパイルしたときに生成されるビルドディレクトリ構造について説明します。ソースディレクトリとビルドディレクトリは共に、後続のチュートリアルでデプロイおよびパッケージ化する WebLogic 分割開発ディレクトリを構成します。

前提条件

手順

次の手順に従って、MedRec アプリケーションスイートのソースディレクトリ構造について学習します。

手順 1 : エンタープライズアプリケーションのディレクトリ構造を調べる

WebLogic 分割開発ディレクトリには、エンタープライズアプリケーション (EAR) レベル以下のソースファイルが格納されます。開発している Web アプリケーションまたは EJB が 1 つだけの場合でも、エンタープライズアプリケーションを表す最上位のディレクトリに関連するコンポーネントを格納します。physicianEar サブディレクトリの内容に注目してください。

ディレクトリのリストから、Physician アプリケーションには、Web アプリケーションコンポーネント (physicianWebApp ディレクトリに格納)、EJB コンポーネント (physSessionEjbs ディレクトリに格納)、および Web サービス (webServices ディレクトリに格納) が含まれることがわかります。分割開発ディレクトリ構造では、各 EAR コンポーネントが専用のソースディレクトリに置かれている必要があります。コンポーネントの種類は、wlcompile Ant タスクによりコンパイル時に自動的に決定されるため、ear ディレクトリとコンポーネントサブディレクトリには自由に名前を付けることができます。

META-INF サブディレクトリには、エンタープライズアプリケーション自体のデプロイメント記述子 (application.xml と省略可能な weblogic-application.xml ファイル) が保持されます。

手順 2 : Web アプリケーションコンポーネントのディレクトリ構造を調べる

MedRec の Web アプリケーションは Struts を使用して開発されます。Struts は Apache Jakarta プロジェクトで開発されたオープンソースの Web フレームワークです。

ソースディレクトリ構造で、Web アプリケーションを構成するさまざまなファイルタイプ (JSP、サーブレット、Struts フレームワークで必要なファイルなど) を簡単に管理できます。physicianEar ソースディレクトリ内の physicianWebApp サブディレクトリに移動して、その内容を調べます。

07/24/2006  02:49 PM    <DIR>          .
07/24/2006  02:49 PM    <DIR>          ..
07/24/2006  02:42 PM            12,950 Confirmation.html
07/24/2006  02:42 PM             1,639 Confirmation.jsp
07/24/2006  02:42 PM            41,763 CreatePrescription.html
07/24/2006  02:42 PM             5,389 CreatePrescription.jsp
07/24/2006  02:42 PM            87,839 CreateVisit.html
07/24/2006  02:42 PM            11,961 CreateVisit.jsp
07/24/2006  02:42 PM            14,708 Error.html
07/24/2006  02:42 PM             1,905 Error.jsp
07/24/2006  02:42 PM            32,486 Login.html
07/24/2006  02:42 PM             4,074 Login.jsp
07/24/2006  02:42 PM            15,377 PatientHeader.html
07/24/2006  02:42 PM             2,309 PatientHeader.jsp
07/24/2006  02:42 PM             7,365 PhysicianHeader.html
07/24/2006  02:42 PM               964 PhysicianHeader.jsp
07/24/2006  02:42 PM            30,765 Search.html
07/24/2006  02:42 PM             3,896 Search.jsp
07/24/2006  02:42 PM            29,938 SearchResults.html
07/24/2006  02:42 PM             4,243 SearchResults.jsp
07/24/2006  02:42 PM             5,971 stylesheet.css
07/24/2006  02:42 PM            24,957 ViewProfile.html
07/24/2006  02:42 PM             3,742 ViewProfile.jsp
07/24/2006  02:42 PM            46,175 ViewRecord.html
07/24/2006  02:42 PM             6,707 ViewRecord.jsp
07/24/2006  02:42 PM            37,675 ViewRecords.html
07/24/2006  02:42 PM             5,504 ViewRecords.jsp
07/24/2006  02:49 PM    <DIR>          WEB-INF

Web アプリケーションサブディレクトリの最上位には、アプリケーションを構成する JSP が含まれます。各 JSP に対応する HTML ファイルもあります。この HTML ファイルは JSP コードを単に HTML 形式で表示するもので、読みやすいように行番号付きで色分けされています。これらの HTML ファイルはチュートリアルのためにのみ含まれています。通常は、これらの HTML ファイルをアプリケーションに含めないでください。ここに追加の .html ファイルやその他の静的なコンテンツ (画像ファイルなど) も格納できますが、これらのコンテンツは専用のサブディレクトリ (\html_files や \images など) に格納する方が、扱いが簡単になります。

サーブレット (Struts の用語では「アクション」) や補助的なユーティリティクラスなどの Web アプリケーションコンポーネントの Java ソースファイルは、コンポーネントの WEB-INF\src サブディレクトリの下のパッケージディレクトリに格納されます。たとえば、Physician Web アプリケーションのユーティリティクラスは、C:\medrec_tutorial\src\physicianEar\physicianWebApp\WEB-INF\src\com\bea\medrec\actions\PhysicianConstants.java に格納されます。

wlcompile タスクにより、WEB-INF\src サブディレクトリの内容が自動的にアプリケーションの出力ディレクトリの WEB-INF\classes サブディレクトリにコンパイルされ、Web アプリケーションのすべてのコンポーネントからこれらのクラスにアクセスできるようになります。

WEB-INF サブディレクトリには、Web アプリケーションコンポーネントのデプロイメント記述子 (web.xml と省略可能な weblogic.xml) や Struts 関連のファイル (struts-config.xml など) も格納されます。

physician Web アプリケーションで使用される画像は physicianWebApp ディレクトリには格納されませんが、すべての MedRec アプリケーションが共有している共通のディレクトリに格納されます。physician Web アプリケーションの weblogic.xml デプロイメント記述子ファイルでは、以下のように、これらの画像の実際の場所を指定する仮想ディレクトリを定義します。

手順 3 : EJB コンポーネントのディレクトリ構造を調べる

EJB コンポーネントの Java ソースファイルは、EJB のパッケージ構造を反映したサブディレクトリに格納されます。たとえば、Physician アプリケーションのセッション EJB のソースは、C:\medrec_tutorial\src\physicianEar\physSessionEjbs\com\bea\medrec\controller\PhysicianSessionEJB.ejb に格納されます。

EJB コンポーネントのデプロイメント記述子 (ejb-jar.xml と省略可能な weblogic-ejb-jar.xml など) は、コンポーネントの META-INF サブディレクトリに格納できます。ただし、physSessionEjbs サブディレクトリを見ると、META-INF サブディレクトリがありません。これは、MedRec アプリケーションスイートのすべての EJB が、デプロイメント記述子ファイルで定義するのではなく、ejbgen メタデータアノテーションを使用して EJB の形式と動作を指定するためです。ejbgen アノテーションは、新しい JDK 5.0 メタデータアノテーションの機能に基づいています。wlcompile Ant タスクは、*.ejb ファイルを処理するときに EJBGen ユーティリティを呼び出します。EJBGen ユーティリティはこれらのアノテーションを使用して、アプリケーションのコンパイル時に自動的に EJB デプロイメント記述子を生成します。

手順 4 : Web サービスのディレクトリ構造を調べる

J2EE Web サービスコンポーネントの Java ソースファイルは、Web サービスのパッケージ構造を反映したサブディレクトリに格納されます。たとえば、Physician Web サービス (medrecEar アプリケーションの Web サービスを確実に呼び出す) のソースは C:\medrec_tutorial\src\physicianEar\webServices\com\bea\medrec\webservices\PhysicianWebServices.java に格納されます。

MedRec アプリケーションスイートのすべての Web サービスは Java Web サービス (JWS) ファイルを使用して実装されます。JWS ファイルは Web サービスの中心部分であり、Web サービスの動作を決定する Java コードが含まれています。JWS ファイルは、JDK 5.0 メタデータアノテーションを使用して Web サービスの形式や特性を指定した、通常の Java クラスファイルです。JWS ファイルで使用できる JWS アノテーションには、Web Services Metadata for the Java Platform 仕様 (JSR-181) で定義された標準のアノテーションと、WebLogic 固有のアノテーションがあります。

MedRec アプリケーションは jwsc Web サービス Ant タスクを使用して、JWS ファイルをデプロイ可能な Web サービスにコンパイルします。Enterprise Web Services 1.1 仕様 (JSR-921) で定義されているように、Web サービスはプレーンな Java クラス (Web アプリケーション WAR としてパッケージ化) またはステートレスセッション EJB (EJB JAR としてパッケージ化) によって実装できます。jwsc Ant タスクは、生成するバックエンドコンポーネントの種類を自動的に決定して、デプロイメント記述子、ユーザ定義のデータ型コンポーネント、WSDL ファイルなどのサポートファイルをすべて生成します。したがって、ejbgen アノテーションを使用する EJB と同様に、Web サービスを記述した JWS ファイルのみが \src ディレクトリに格納されます。

ベストプラクティス

アプリケーションのコンパイルおよびデプロイに WebLogic Server のビルドスクリプトを利用できるように、独自の J2EE アプリケーションプロジェクトと同じソースディレクトリ構造を使用してください。次に、WebLogic 分割開発ディレクトリ構造形式に準拠した簡単なソースディレクトリの内容を示します。

\myProject

\myProject\myEar

\myProject\myEar\META-INF\application.xml

\myProject\myEar\myEjb\com\*\MyEjbGenEjb.ejb

\myProject\myEar\myEjb\com\*\*.java

\myProject\myEar\myWebService\com\*.*.java

\myProject\myEar\myWebApp\*.jsp

\myProject\myEar\myWebApp\WEB-INF\web.xml

\myProject\myEar\myWebApp\WEB-INF\src\com\*\*.java

ソースディレクトリ階層内のファイル管理に、ソース制御システムを使用してください。ソースディレクトリに、Java ファイルやデプロイメント記述子などの作業ファイルが含まれます。開発プロジェクトの履歴を維持するために、定期的にバックアップしてください。
ユーザが作成したファイルを \build ディレクトリに格納しないでください。\build ディレクトリは、J2EE アプリケーションのコンパイル済みクラスだけを格納するためのものです。アプリケーションを再コンパイルするだけで \build ディレクトリ全体を再ビルドできるようにしてください。
デプロイメント記述子ファイルは、J2EE コンポーネントサブディレクトリの最上位、またはコンポーネントの記述子ファイル用に作成したカスタム J2EE サブディレクトリ (\myWebApp\WEB-INF または \myEjb\META-INF) のどちらにでも格納できます。
wlcompile Ant タスクを実行して EJB などの他のすべてのコンポーネントをコンパイルする前に、jwsc Web サービス Ant タスク (JWS ファイルを Web サービスにコンパイルする) を実行します。

全体像

MedRec アプリケーションスイートでは、3 つの分割開発ディレクトリを使用して、medrecEar、physicianEar、および startBrowserEar の各アプリケーションのソースを保持します。これらのアプリケーション間で共有されるユーティリティクラスは、分割ディレクトリ構造を使用しないカスタムビルドスクリプトと共に、専用の common ディレクトリに格納されます。セキュリティコンポーネントもカスタムビルドディレクトリにステージングされます。

最上位の build.xml ファイルが MedRec ソースディレクトリを検索し、すべてのコンポーネントのビルドを即座に調整します。

wlcompile Ant タスクによるビルド時に、ほとんどのコンポーネント依存関係が自動的に維持されますが、medrecEar、physicianEar などの特定の分割開発ディレクトリではビルド順序がハードコード化されて依存関係が強制的に設定されます。このチュートリアルで作成したソースディレクトリ構造には、依存関係を意識せずに新しい WebLogic Server Ant タスクを使用してビルドできる中間手順が含まれます。

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