ヘッダーをスキップ
Oracle® Fusion Middleware Oracle TopLinkソリューション・ガイド
11g リリース1 (11.1.1)
B66616-01
  目次へ移動
目次
前
前 		 次
次		  

4 コンポジット永続性ユニットによる複数データベースの使用

TopLinkでは、コンポジット永続性ユニットを使用して、(エンティティ・タイプの独自のセットがそれぞれに設定された)複数の永続性ユニットを単一の永続性コンテキストとして公開できます。コンポジット永続性ユニットの一部である個々の永続性ユニットを、コンポジット・メンバー永続性ユニットと呼びます。

この章では、次の項目について説明します。

4.1 コンポジット永続性ユニットの理解

コンポジット永続性ユニットでは、次のことを行えます。

例4-1は、1つのコンテキストから2つの異なるデータベースにデータを永続化する方法を示しています。

例4-1 複数のデータベースの使用

em.persist(new A(..));
em.persist(new B(..));
// You can insert A into database1 and insert B into database2.
// The two databases can be from different vendors.

em.flush();

図4-1 単純なコンポジット永続性ユニット

図4-1の説明が続きます
図4-1「単純な複数永続性ユニット」の説明

図4-1は、単純な複数永続性ユニットを示しています。EntityManagerは、(Persistence.createEntityManagerFactoryメソッドにそれらを渡して)次の2つの複合メンバー永続性ユニットを含む複合永続性ユニットをインスタンス化します。

4.1.1 コンポジット永続性ユニットの要件

コンポジット永続性ユニットを使用する際には、次の要件に注意してください。

  • 各コンポジット・メンバー永続性ユニットの名前は、コンポジット内で一意である必要があります。

  • 永続性ユニット全体に対応するtransaction-typeおよび他のプロパティ(ターゲット・サーバー、ロギング・トランザクションなど)はコンポジット永続性ユニットで定義してください。そうしないと、アプリケーションはデフォルトを使用します。

  • すべてのコンポジット・メンバー永続性ユニットで、同じtransaction-typeをコンポジット永続性ユニットとして使用する必要があります。

4.2 主なタスク

この項には、次の項目が含まれます。

4.2.1 タスク1: コンポジット永続性ユニットの構成

コンポジット永続性ユニットは通常の永続性要素なので、persistence.xmlファイルが必要です。例4-2に、persistence.xmlのサンプル・ファイルを示します。

例4-2 コンポジット永続性ユニットのpersistence.xmlファイル

<persistence 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 persistence_1_0.xsd" version="1.0">
    <persistence-unit name="compositePu" transaction-type="JTA">
        <provider>
            org.eclipse.persistence.jpa.PersistenceProvider
        </provider>
 
        <jar-file>member1.jar</jar-file>
        <jar-file>member2.jar</jar-file> 
        <properties>
            <property name="eclipselink.composite-unit" value="true"/>
            <property name="eclipselink.target-server" value="WebLogic_10"/>
        </properties>
    </persistence-unit>
</persistence>

<property name="eclipselink.composite-unit" value="true"/>プロパティを使用して、永続性ユニットをコンポジットとして指定します。

<jar-file>要素を使用して、コンポジット・メンバー永続性ユニットを含むJARファイルを指定します。コンポジット永続性ユニットには、指定したJARファイルで見つかったすべての永続性ユニットが含まれます。

4.2.2 タスク2: コンポジット永続性ユニットの使用

コンポジット永続性ユニットは他の永続性ユニットと同様に使用できます。次に示すように、EntityManagerを注入できます。

@PersistenceUnit(unitName="compositePu")
EntityManagerFactory entityManagerFactory;

@PersistenceUnit(unitName="compositePu")
EntityManager entityManager;

また、手動で作成することもできます。

EntityManagerFactory entityManagerFactory = Persistence.createEntityManagerFactory("compositePu", properties);

4.2.3 タスク3: コンポジット永続性ユニットのデプロイ

複数の永続性ユニットをデプロイするには、同じクラス・ローダーのすべてのJAR (コンポジットおよびそのメンバー)をデプロイします。

  • Oracle WebLogic Serverにデプロイする際には、JARをEARファイルにパッケージ化します。

  • スタンドアロン・アプリケーションとして実行する際には、JARをクラス・パスに追加します。

重要な情報および制限は、4.1.1項「コンポジット永続性ユニットの要件」を参照してください。

4.3 その他の参照資料

コンポジット永続性ユニットに関する次のような追加情報は、EclipseLinkドキュメントのhttp://wiki.eclipse.org/EclipseLink/UserGuide/JPA/Advanced_JPA_Development/Composite_Persistence_Unitsを参照してください。

4.3.1 Javadoc

詳細は、『Oracle Fusion Middleware Java API Reference for EclipseLink』の次のAPIを参照してください。

  • PersistenceUnitPropertiesクラス

  • Persistence.createEntityMangerクラス

  • EntityManagerFactoryインタフェース

  前
前 		 次
次
  目次へ移動
目次