Oracle® Fusion Middleware Oracle WebLogic Server ActiveCacheによるアプリケーションのデプロイ 12c (12.1.2) E48068-01 |
|
![]() 前 |
この章では、TopLink Gridにより、Java Persistence API (JPA)を使用するアプリケーション開発の標準化および簡略化と、OracleのCoherence Data Gridの拡張性および分散処理能力を統合する仕組みについて説明します。開発者はJPAにかけた投資を使用し、Coherenceの拡張性を利用できます。標準JPAアプリケーションは、ActiveCacheではなく主要データ・ストア(通常はリレーショナル・データベース)と直接相互通信を行うため、TopLink Grid開発者はCoherenceデータ・グリッド内のドメイン・モデルの一部または全部を保存するよう選択できます。
注意: WebLogic Server 12.1.2には、WebLogic Serverドメイン内でのCoherenceアプリケーションのデプロイおよび管理方法を標準化するCoherenceコンテナ統合が含まれています。このガイドでは、下位互換性を考慮してCoherenceの設定手順が示されています。新しい実装ではCoherenceコンテナ統合を使用する必要があります。Coherenceベースのアプリケーションのパッケージ化の詳細は、『Oracle WebLogic Server Oracle Coherenceアプリケーションの開発』を参照してください。WebLogic ServerドメインでのCoherenceクラスタの作成および構成の詳細は、『Oracle WebLogic Serverクラスタの管理』を参照してください。 |
この章の内容は次のとおりです:
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は、サンプル・マニフェスト・ファイルを示します。