Oracle® Fusion Middleware Oracle WebLogic Server Enterprise JavaBeansバージョン3.0のプログラミング 11g リリース1(10.3.4) B61625-02 |
|
前 |
次 |
この章では、WebLogic ServerでのOracle Kodoアプリケーションの開発、デプロイメント、および構成について概説します。以下の内容について説明します。
注意: Oracle Kodo JPA/JDOはこのリリースで非推奨になりました。Oracle TopLinkの使用を検討することをお薦めします。Oracle TopLinkの詳細は、「WebLogic ServerでのOracle TopLinkの使用」を参照してください。TopLinkを使用する場合、JPA 2.0をサポートするパッチをWebLogic Serverにインストールできます。詳細は、「WebLogic ServerにおけるJPA 2.0とTopLinkの併用」を参照してください。Kodoを使用している場合は、WebLogic ServerはJPA 2.0をサポートしません。 |
Oracle Kodoは、Sun MicrosystemのJava Persistence API (JPA)およびJava Data Objects (JDO)仕様の、透過的なデータ・オブジェクト用の実装です。Oracle Kodoは、スタンドアロン製品として使用することも、WebLogic Serverに統合することもできます。
この章では、WebLogic ServerでJPAやJDOを使用してアプリケーションを実装する方法について説明します。WebLogic Serverでは、JPAおよびJDO実装が、WebLogic Server全体のEnterprise JavaBean 3.0永続性実装の一部になっています。
JPAおよびJDOを使用したアプリケーションの作成に関する一般的な情報については、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドを参照してください。
WebLogic ServerにOracle Kodoアプリケーションを実装するには、最初にアプリケーションのコードを記述する必要があります。Oracle Kodoを使用してデータの永続性を管理するアプリケーションの記述については、以下のリソースを参照してください。
Oracle Kodoを使用してアプリケーションを作成する手順を理解し、実際にアプリケーションを作成したら、WebLogic Serverを使用してアプリケーションをデプロイおよび構成します。手順については、以降の節を参照してください。
WebLogic Serverでデフォルトで提供されているOracle Kodoとは異なるバージョンのOracle Kodoを使用する場合は、FilteringClassLoader
を使用して、システム・クラス・ローダーからではなくアプリケーションからロードするパッケージ(この場合はOracle KodoとOpenJPA)を指定する必要があります。
以下の例では、weblogic-application.xml
を使用して、アプリケーションからOracle KodoおよびOpenJPAパッケージをロードする方法を示します。
<prefer-application-packages> <package-name>org.apache.openjpa.*</package-name> <package-name>kodo.*</package-name> </prefer-application-packages>
フィルタリング・クラスローダーの詳細は、『Oracle Fusion Middleware Oracle WebLogic Serverアプリケーションの開発』の「WebLogic Serverアプリケーションのクラス・ローディングについて」を参照してください。
その後で、『Oracle Fusion Middleware Oracle WebLogic Serverアプリケーションの開発』の「ライブラリ・ディレクトリ」で説明するように、ライブラリ・ディレクトリを使用して、Oracle KodoおよびOpenJPAをアプリケーション内にパッケージ化できます。
以下の節では、永続性を構成する方法について説明します。
Oracle Kodoでは、次の表に示す2つのXMLファイルを使用して構成プロパティを定義します。
表7-1 永続性構成ファイル
構成ファイル | 説明 |
---|---|
|
JPA機能仕様で定義されているOracle Kodo構成パラメータ。このファイルは必須です。 この構成を構造化するためのXMLスキーマは、 詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドの第6章「永続性」を参照してください。 |
|
Oracle Kodo固有の構成パラメータ。このファイルは、アプリケーションのデプロイメントにおいて必須ではありません。これを指定する場合でも、 デプロイメントに この構成を構造化するためのXMLスキーマは、 注意: Java SE環境で |
必要に応じて構成ファイルを編集し、永続性を構成します。永続性ユニットは、WARまたはEJB JARファイルの一部としてパッケージ化するか、WARまたはEARファイルに含めることのできるJARファイルとしてパッケージできます。これらのファイルは、永続性ユニットのルートにあるMETA-INF
ディレクトリ内のリソースとして使用できるようにする必要があります。永続性ユニットのルートは、コンテナ環境では以下のいずれかになります。
EJB-JARファイル
WARファイルのWEB-INF/classes
ディレクトリ
WARファイルのWEB-INF/lib
ディレクトリ内のJARファイル
EARのルートにあるJARファイル
EARライブラリ・ディレクトリ内のJARファイル
アプリケーション・クライアントjarファイル
ここでは、これらの構成ファイルを組み合せて使用する場合の考慮事項について説明します。
persistence-configuration.xml
を使用する場合は、Oracle Kodo固有のすべてのプロパティを、persistence.xml
ファイルではなくpersistence-configuration.xml
ファイルに含める必要があります。その場合、WebLogic Server管理コンソールとWebLogic Scripting Tool (WLST)では、永続性ユニットがOracle Kodo永続性ユニットとして認識され、高度な構成とチューニング可能なサポートが提供されます。
Oracle Kodo固有のプロパティがpersistence.xml
ファイルに含まれていない場合、WebLogic Server管理コンソールとWebLogic Scripting Tool (WLST)では、永続性ユニットがサード・パーティの永続性ユニットとして認識されます。
persistence-configuration.xml
記述子が使用可能で、特定の永続性ユニットのエントリが含まれている場合は、Oracle Kodo (kodo
)やOpenJPA (openjpa
)のプロパティを、その永続性ユニットのpersistence.xml
ファイルの<properties>
タグで指定できます。
Oracle Kodoは高度なカスタマイズが可能な環境であるため、構成プロパティの多くが、システム・プラグインの作成および構成に関係しています。プラグイン・プロパティの構文は、Javaアノテーションの構文によく似ています。プラグイン・プロパティを使用することで、プラグインにどのクラスを使用するか、また、インスタンス化されたプラグイン・インスタンスのパブリック・フィールドやBeanプロパティをどのように構成するかを指定できます。
基本的に、プラグインは名前と値のペアによる一連のプロパティを使用して定義します。次のサンプルでは、persistence.xml
内でプラグインを定義する方法を示します。
<properties> <property name='myplugin.DataCache' value='com.bea.MyDataCache(CacheSize=1000, RemoteHost='CacheServer)'> </properties>
Oracle Kodoアプリケーションをデプロイする前に、以下のタスクを完了する必要があります。
Oracle Kodoアプリケーションを作成します。詳細については、「Oracle Kodoアプリケーションの作成」を参照してください。
永続性を構成します。詳細については、「永続性の構成」を参照してください。
アプリケーションを作成し、.ear
または.war
にアーカイブします。
これらのタスクが完了したら、そのアプリケーションをWebLogic Serverにデプロイできます。構成が完了していれば、Oracle Kodoアプリケーションは他のアプリケーションと同じ方法でデプロイできます。アプリケーションのデプロイメントの詳細は、『Oracle Fusion Middleware Oracle WebLogic Serverへのアプリケーションのデプロイ』を参照してください。
注意: 管理コンソールでは、新しい永続性ユニットを作成することはできません。新しい永続性ユニットを作成するには、persistence.xml を手動で編集する必要があります。 |
Oracle Kodoアプリケーションをデプロイしたら、persistence.xml
およびpersistence-configuration.xml
で定義されている構成パラメータを変更できます。
以下の節では、Oracle Kodoアプリケーションを管理コンソールで構成する方法と、管理コンソールを使用せずに構成する方法について説明します。
デプロイしたアプリケーションの永続性がpersistence.xml
で定義されている場合は、次の手順で管理コンソールから構成にアクセスできます。
「デプロイメント」を選択します。
構成したい永続性ユニットが含まれているモジュールの名前を選択します。
「構成」タブを選択します。
「永続性」タブを選択します。
表示された一覧から、構成する永続性ユニットを選択します。
これによって、管理コンソールで編集可能なすべてのOracle Kodo永続性パラメータにアクセスできるようになります。
管理コンソールを使用できない環境でパラメータを変更する必要がある場合は、以下の方法で変更できます。
アプリケーションと一緒にアーカイブされているpersistence.xml
およびpersistence-configuration.xml
ファイルを手動で編集します。
SessionHelper
を使用してデプロイメント・プランにアクセスして構成します。詳細は、『Oracle Fusion Middleware Oracle WebLogic Serverデプロイメントのプログラミング』の「WebLogicデプロイメントAPIについて」にあるToolsパッケージに関する項のSessionHelperを参照してください。
WLST loadApplication()
メソッドを使用して、アプリケーション・デプロイメント・プランをロードして更新します。詳細は、『Oracle Fusion Middleware Oracle WebLogic Scripting Tool』の「デプロイメント・プランの更新」を参照してください。
デプロイメント・プランを手動で編集します。詳細は、『Oracle Fusion Middleware Oracle WebLogic Serverへのアプリケーションのデプロイ』の「デプロイするアプリケーションの新しい環境へのエクスポート」のデプロイメント・プランの手動カスタマイズに関する項を参照してください。