composite-unit.member

eclipselink.composite-unit.memberを使用して、永続性ユニットがコンポジット永続性ユニットのメンバーであるかどうかを指定します。

値

表5-22は、この永続性プロパティの値を説明しています。

表5-22 composite-unit.memberの有効値

Value	説明
`true`	永続性ユニットはコンポジット永続性ユニットのメンバーである必要があり、単独の永続性ユニットとしては使用できません。
`false`	永続性ユニットは、コンポジット永続性ユニットのメンバーである必要はありません。

使用方法

このプロパティをtrueに設定すると、永続性ユニットに、他の永続性ユニットに対する依存性があることを示します。

注意:

このプロパティは、createEntityManagerFactoryメソッドに渡されるか、またはシステム・プロパティで設定されている場合、無視されます。

このプロパティがtrueに設定されている場合、EntityManagerFactoryを引き続き作成できますが、接続することはできません。エンティティ・マネージャを作成しようとすると、例外が発生します。

問合せヒント

コンポジット永続性ユニットについてネイティブ問合せを実行する場合、composite-unit.memberを使用して、問合せの実行対象であるコンポジット・メンバー永続性ユニットの名前を指定します。

例

例5-12に、persistence.xmlファイルでこの永続性プロパティの拡張機能を使用する方法を示します。

例5-12 persistence.xmlでのcomposite-unit.memberの使用

コンポジット・メンバー永続性ユニットmemberPu2が、member2.jarファイルで定義されています。これは、member1.jarで定義されたクラスに対する依存性があり、単独では使用できません。

<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="memberPu2">
        <provider>
            org.eclipse.persistence.jpa.PersistenceProvider
        </provider>
        <mapping-file>META-INF/advanced-entity-mappings2.xml</mapping-file>
        <jta-data-source>jdbc/MySqlJtaDS</jta-data-source>
        <exclude-unlisted-classes>false</exclude-unlisted-classes>
        <properties>
            <property name="eclipselink.composite-unit.member" value="true"/>
            <property name="eclipselink.target-database" value="org.eclipse.persistence.platform.database.MySQLPlatform"/>
        </properties>
    </persistence-unit>
</persistence>