Oracle® Fusion Middleware Oracle WebLogic Server 10.3.6でのActiveCacheの使用 11gリリース1 (10.3.6) B65046-04 |
|
![]() 前 |
この章では、WebLogic Server 10.3.6でActiveCacheを使用して関係データにアクセスして取得する方法について説明します。TopLink Gridは、Java Persistence API (JPA)を使用するアプリケーション開発の標準化と簡略化を、OracleのCoherence Data Gridの拡張性と処理能力に結合します。開発者はJPAにかけた投資を使用し、Coherenceの拡張性を利用できます。標準JPAアプリケーションは、ActiveCacheではなく主要データ・ストア(通常はリレーショナル・データベース)と直接相互通信を行うため、TopLink Grid開発者はCoherenceデータ・グリッド内のドメイン・モデルの一部または全部を保存するよう選択できます
Coherence環境でのTopLink Gridの構成の詳細は、『Oracle TopLinkおよびCoherence Grid統合ガイド』を参照してください。
この章の内容は次のとおりです:
persistence.xml
ファイルはJPA永続性ディスクリプタ・ファイルです。ここで、永続性ユニット、永続性プロバイダ、およびこのリファレンスで記載するすべてのベンダー固有拡張を構成します。
このファイルでは、provider
要素によりベンダーの永続性プロバイダ・クラスの名前が指定されます。Oracle TopLinkを使用している場合、この要素の値としてorg.eclipse.persistence.jpa.PersistenceProvider
を入力します。
例4-1 サンプルpersistence.xmlファイル
<?xml version="1.0" encoding="UTF-8"?>
<persistence version="2.0" xmlns="http://java.sun.com/xml/ns/persistence" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://java.sun.com/xml/ns/persistence http://java.sun.com/xml/ns/persistence/persistence_2_0.xsd">
<persistence-unit name="JPA" transaction-type="RESOURCE_LOCAL">
<provider>org.eclipse.persistence.jpa.PersistenceProvider</provider>
<class>com.oracle.handson.Employees</class>
...
「アプリケーションのパッケージ化とCoherenceクラスタ・スコープの構成」で説明したように、Coherenceクラスタは、クラスローダー階層内にcoherence.jar
ファイルを配置する場所に従い、クラスローダー・スコープを指定されます。Coherenceクラスタは、アプリケーション・サーバー・スコープ、EARスコープ、またはWARスコープにすることができます。TopLink Grid機能をクラスタ内で実行されているアプリケーションで使用可能にするには、クラスパスにTopLink Grid JARファイルも追加する必要があります。
TopLink Grid JARファイル、toplink-grid-1.0.jar
には、TopLinkがOracle Coherenceと相互作用するためのクラスが含まれます。このファイルはWebLogic Server分散のcommon\deployable-libraries
フォルダにあります。
次の項では、アプリケーション・サーバー・スコープ、EARスコープおよびWARスコープのクラスタ環境用のJARを追加する方法について説明します。
TopLink Gridを使用してCoherenceキャッシュにJPAエンティティを保存する場合、次の手順を実行します。
「アプリケーション・サーバー・スコープのCoherenceクラスタの構成」の手順に従い、coherence.jar
とactive-cache.jar
をシステム・クラスパスにインクルードします。
WebLogic Serverシステム・クラスパスを編集して、toplink-grid-1.0.jar
をシステム・クラスパスにインクルードします。
TopLink Gridを使用してCoherenceキャッシュにJPAエンティティを保存する場合、次の手順を実行します。
「EARスコープのCoherenceクラスタの構成」の手順に従い、coherence.jar
およびactive-cache.jar
ファイルを共有ライブラリとしてデプロイします。
次のいずれかの方法を使用して、toplink-grid-1.0.jar
を共有ライブラリとしてデプロイします。
WebLogic Server管理コンソールまたはコマンドラインを使用して、toplink-grid-1.0.jar
を共有ライブラリとしてデプロイします。
java weblogic.Deployer -username <> -password <> -adminurl <> -deploy toplink-grid-1.0.jar -name toplink-grid -library -targets <>
toplink-grid-1.0.jar
を共有ライブラリとしてデプロイする場合、weblogic-application.xml
ファイル内のライブラリをlibrary-ref
として参照します。例4-2は、weblogic-application.xml
ファイルで参照されるtoplink-grid-1.0.jar
を示します。
例4-2 weblogic-application.xmlファイルでのTopLink Grid JARファイルの参照
<weblogic-application> ... <library-ref><library-name>coherence</library-name>
</library-ref> ... <library-ref><library-name>active-cache</library-name>
</library-ref> <library-ref><library-name>toplink-grid</library-name>
</library-ref> ... </weblogic-application>
toplink-grid-1.0.jar
をアプリケーションEARのAPP-INF/lib
フォルダにコピーします。ただし、共有ライブラリとしてデプロイする方法が優先されます。
TopLink Gridを使用してCoherenceキャッシュにJPAエンティティを保存する場合、次の手順を実行します。
「WARスコープのCoherenceクラスタの構成」の手順に従い、coherence.jar
およびactive-cache.jar
ファイルをデプロイします。
WebLogic Server管理コンソールまたはコマンドラインを使用して、toplink-grid-1.0.jar
をデプロイします。次に示すのはサンプル・コマンド・ラインです。
java weblogic.Deployer -username <> -password <> -adminurl <> -deploy toplink-grid-1.0.jar -name toplink-grid -library -targets <>
toplink-grid-1.0.jar
をオプション・パッケージとして、Coherenceを使用するオプションの各モジュールのmanifest.mf
ファイルにインポートします。代替方法として、アプリケーションWARのWEB-INF/lib
ディレクトリのそれぞれに対してファイルをコピーできます。
例4-3は、サンプル・マニフェスト・ファイルを示します。