|
|
この章では、WebLogic Server での BEA Kodo アプリケーションの開発、デプロイメント、およびコンフィグレーションについて概説します。以下の内容について説明します。
BEA Kodo は、Sun Microsystem の Java Persistence API (JPA) および Java Data Objects (JDO) 仕様の、透過的なデータ オブジェクト用の実装です。BEA 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 に BEA Kodo アプリケーションを実装するには、最初にアプリケーションのコードを記述する必要があります。BEA Kodo を使用してデータの永続性を管理するアプリケーションの記述については、以下のリソースを参照してください。
BEA 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 アプリケーションのクラスローディングについて」を参照してください。
BEA Kodo には、コンフィグレーション プロパティを保持する以下の 2 つの XML ファイルが含まれています。
Kodo は高度なカスタマイズが可能な環境であるため、コンフィグレーション プロパティの多くが、システム プラグインの作成およびコンフィグレーションに関係しています。プラグイン プロパティの構文は、Java アノテーションの構文によく似ています。プラグイン プロパティを使用することで、プラグインにどのクラスを使用するか、また、インスタンス化されたプラグイン インスタンスのパブリック フィールドや Bean プロパティをどのようにコンフィグレーションするかを指定できます。
基本的に、プラグインは名前と値のペアによる一連のプロパティを使用して定義します。次のサンプルでは、persistence.xml 内でプラグインを定義する方法を示します。
<property name='myplugin.DataCache' value='com.bea.MyDataCache(CacheSize=1000, RemoteHost='CacheServer)'>
Kodo アプリケーションをデプロイする前に、以下のタスクを完了する必要があります。
これらのタスクが完了したら、そのアプリケーションを WebLogic Server にデプロイできます。コンフィグレーションが完了していれば、Kodo アプリケーションは他のアプリケーションと同じ方法でデプロイできます。アプリケーションのデプロイメントの詳細については、「<xref to deployment>」を参照してください。
Kodo アプリケーションのデプロイメントが完了したら、persistence.xml および persistence-configuration.xml 内に定義されているコンフィグレーション パラメータを変更できます。以下の内容について説明します。
多くの Kodo コンフィグレーション パラメータは、WebLogic Server Administration Console を使用してコンフィグレーションできます。
デプロイしたアプリケーションの永続性が persistence.xml で定義されている場合は、次の手順で Administration Console からコンフィグレーションにアクセスできます。
これによって、Administration Console で編集可能なすべての Kodo 永続性パラメータにアクセスできるようになります。Administration Console で変更できないパラメータを変更したり、パラメータを手動で変更したりする必要がある場合は、「Administration Console を使用しない Kodo コンフィグレーション」を参照してください。
| 注意 : | Administration Console では、新しい永続性ユニットを作成することはできません。新しい永続性ユニットを作成するには、persistence.xml を手動で編集する必要があります。 |
  
|
