|
|
この章では、WebLogic Server での Oracle Kodo アプリケーションの開発、デプロイメント、およびコンフィグレーションについて概説します。以下の内容について説明します。
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 Java Bean 3.0 永続性実装の一部になっています。
JPA および JDO を使用したアプリケーションの作成に関する一般的な情報については、『Kodo Developer’s Guide』を参照してください。
WebLogic Server に Oracle Kodo アプリケーションを実装するには、最初にアプリケーションのコードを記述する必要があります。Oracle Kodo を使用してデータの永続性を管理するアプリケーションの記述については、以下のリソースを参照してください。
Oracle Kodo を使用してアプリケーションを作成する手順を理解し、実際にアプリケーションを作成したら、WebLogic Server を使用してアプリケーションをデプロイおよびコンフィグレーションします。手順については、以降の節を参照してください。
WebLogic Server に付属している Kodo とはバージョンが異なる Kodo を使用する場合は、FilteringClassLoader を使用して、Kodo および OpenJPA ライブラリをコンポーネント クラスパスから除外する必要があります。
次のサンプルでは、weblogic-application.xml でこれらのクラス ライブラリを除外する方法を示します。
<prefer-application-packages>
<package-name>org.apache.openjpa.*</package-name>
<package-name>kodo.*</package-name>
</prefer-application-packages>
フィルタリング クラスローダの詳細については、『WebLogic Server アプリケーションの開発』の「WebLogic Server アプリケーションのクラスローディングについて」を参照してください。
以下の節では、永続性をコンフィグレーションする方法について説明します。
Oracle Kodo では、次の表に示す 2 つの XML ファイルを使用してコンフィグレーション プロパティを定義します。
|
|
|||
persistence.xml 記述子は必要。
http://www.bea.com/ns/weblogic/persistence-configuration.xsd から入手できる。
|
必要に応じてコンフィグレーション ファイルを編集し、永続性をコンフィグレーションします。永続性ユニットは、WAR または EJB JAR ファイルの一部としてパッケージ化するか、WAR または EAR ファイルに含めることのできる JAR ファイルとしてパッケージできます。これらのファイルは、永続性ユニットのルートにある META-INF ディレクトリ内のリソースとして使用できるようにする必要があります。永続性ユニットのルートは、コンテナ環境では以下のいずれかになります。
ここでは、これらのコンフィグレーション ファイルを組み合わせて使用する場合の考慮事項について説明します。
persistence-configuration.xml を使用する場合は、Kodo 固有のすべてのプロパティを、persistence.xml ファイルではなく persistence-configuration.xml ファイルに含める必要があります。その場合、WebLogic Server Administration Console と WebLogic Scripting Tool (WLST) では、永続性ユニットが Kodo 永続性ユニットとして認識され、高度なコンフィグレーションとチューニング可能なサポートが提供されます。persistence.xml ファイルに含まれていない場合、WebLogic Server Administration Console と WebLogic Scripting Tool (WLST) では、永続性ユニットがサード パーティの永続性ユニットとして認識されます。persistence-configuration.xml 記述子が使用可能で、特定の永続性ユニットのエントリが含まれている場合は、Kodo (kodo) や OpenJPA (openjpa) のプロパティを、その永続性ユニットの persistence.xml ファイルの <properties> タグで指定できます。
Kodo は高度なカスタマイズが可能な環境であるため、コンフィグレーション プロパティの多くが、システム プラグインの作成およびコンフィグレーションに関係しています。プラグイン プロパティの構文は、Java アノテーションの構文によく似ています。プラグイン プロパティを使用することで、プラグインにどのクラスを使用するか、また、インスタンス化されたプラグイン インスタンスのパブリック フィールドや Bean プロパティをどのようにコンフィグレーションするかを指定できます。
基本的に、プラグインは名前と値のペアによる一連のプロパティを使用して定義します。次のサンプルでは、persistence.xml 内でプラグインを定義する方法を示します。
<properties>
<property name=’myplugin.DataCache’ value=’com.bea.MyDataCache(CacheSize=1000, RemoteHost=’CacheServer)’>
</properties>
Kodo アプリケーションをデプロイする前に、以下のタスクを完了する必要があります。
.ear または .war にアーカイブする。
これらのタスクが完了したら、そのアプリケーションを WebLogic Server にデプロイできます。コンフィグレーションが完了していれば、Kodo アプリケーションは他のアプリケーションと同じ方法でデプロイできます。アプリケーションのデプロイメントの詳細については、「Oracle WebLogic Server 10g リリース 3 アプリケーションのデプロイメント」を参照してください。
| 注意 : | Administration Console では、新しい永続性ユニットを作成することはできません。新しい永続性ユニットを作成するには、persistence.xml を手動で編集する必要があります。 |
Kodo アプリケーションをデプロイしたら、persistence.xml および persistence-configuration.xml で定義されているコンフィグレーション パラメータを変更できます。
以下の節では、Kodo アプリケーションを Administration Console でコンフィグレーションする方法と、Administration Console を使用せずにコンフィグレーションする方法について説明します。
デプロイしたアプリケーションの永続性が persistence.xml で定義されている場合は、次の手順で Administration Console からコンフィグレーションにアクセスできます。
これによって、Administration Console で編集可能なすべての Kodo 永続性パラメータにアクセスできるようになります。
Administration Console を使用できない環境でパラメータを変更する必要がある場合は、以下の方法で変更できます。
persistence.xml および persistence-configuration.xml ファイルを手動で編集する。SessionHelper を使用してデプロイメント プランにアクセスしてコンフィグレーションする。詳細については、『WebLogic デプロイメント プログラマーズ ガイド』の「WebLogic デプロイメント API について」にある「Tools パッケージ」の「SessionHelper」を参照してください。loadApplication() メソッドを使用し、アプリケーション デプロイメント プランをロードして更新する。詳細については、『WebLogic Scripting Tool ガイド』の「デプロイメント プランの更新」を参照してください。
  
|