5.8.2　<persistence-unit>タグ下に指定するタグ

(a)　O/Rマッピングファイルを使って指定する

永続化ユニットルートのMETA-INFの下，または永続化ユニットから<jar-file>タグで参照している別のJARファイル内のMETA-INFの下に，「orm.xml」という名前のXMLファイルが配置されている場合，<mapping-file>タグに指定しなくても自動的にO/Rマッピングファイルとして扱われます。さらに，<mapping-file>タグにクラスパス上でロードできるXMLファイル名を指定した場合，そのXMLファイルもO/Rマッピングファイルとして扱われます。一つの永続化ユニットに複数のO/Rマッピングファイルが含まれている場合，すべてのO/Rマッピングファイルからマッピング情報が読み込まれます。ただし，複数のO/Rマッピングファイルの間で，重複してマッピングを定義している場合の動作は規定されていません。

(b)　パシステンスクラスを検索するJARファイルを指定する

<jar-file>タグには，パシステンスクラスやO/Rマッピングファイルを含んだJARファイルを指定できます。<jar-file>タグに指定されたJARファイルからは，@Entity，@Embeddable，@MappedSuperclassが付加されたクラスが検索され，マッピング情報が自動的に取得されます。指定したJARファイル内にMETA-INF/orm.xmlが存在する場合，orm.xmlからもマッピング情報が取得されます。なお，<jar-file>タグと<mapping-file>タグを併用することもできます。

<jar-file>タグで指定できるJARファイルは，クラスパスに含まれている必要があります。指定できるのは次に示すJARファイルとなります。

• EARのルートに置いたJARファイル

• EARのライブラリディレクトリに置いたJARファイル

• EJB-JAR

• WARの中のWEB-INF/libに置いたJARファイル

ただし，EARレベルまたはEJB-JARレベルに定義された永続化ユニットの<jar-file>タグに，WARの中のWEB-INF/libに置いたJARファイルを指定することはできません。これは，WARの中のWEB-INF/libに置いたJARファイルはWEBアプリケーション用のクラスローダでロードされるので，WARの中のコンポーネント以外からは参照できないためです。

また，WARレベルに定義された永続化ユニットの<jar-file>タグからは，同じWARの中に含まれたJARファイルだけが指定できます。これは，同じWAR以外の場所に配置されたJARファイルに含まれるクラスは，WARレベルに定義された永続化ユニットのデプロイメントが行われるよりも前にクラスローダによってロードされるおそれがあるためです。このような場合，JPAプロバイダによるバイトコードの変換が正しく実施されないおそれがあります。

<jar-file>タグには，永続化ユニットルートからJARファイルへの相対パスを指定します。指定例を次に示します。

例1

次の図に示す場合の相対パスの指定について説明します。

• EARのlibにエンティティクラスを格納したmyEntities.jarがある。

• EARのルートに置いたEJB-JARのMETA-INF/persistence.xmlの<jar-file>タグでmyEntities.jarを指定する。

この図の場合，永続化ユニットのルートはEJB-JARそのものになるので，EJB-JARからmyEntities.jarへの相対パスを指定します。相対パスは，「lib/myEntities.jar」です。このため，<jar-file>タグに「lib/myEntities.jar」と指定します。

例2

次の図に示す場合の相対パスの指定について説明します。

• EARのルートにエンティティクラスを格納したmyEntities.jarがある。

• EARのlib/myPersistenceUnit.jarのMETA-INF/persistence.xmlの<jar-file>タグでmyEntities.jarを指定する。

この図の場合，永続化ユニットのルートはmyPersistenceUnit.jarになるので，myPersistenceUnit.jarからmyEntities.jarへの相対パスを指定します。相対パスは，「../myEntities.jar」です。このため，<jar-file>タグには「../myEntities.jar」と指定します。

例3

次の図に示す場合の相対パスの指定について説明します。

• WARのWEB-INF/libにエンティティクラスを格納したmyEntities.jarがある。

• WARのWEB-INF/classes/META-INF/persistence.xmlの<jar-file>タグでmyEntities.jarを指定する。

この図の場合，永続化ユニットルートはWARのWEB-INF/classesになるので，WEB-INF/classesからmyEntities.jarへの相対パスを指定します。相対パスは「../lib/myEntities.jar」です。このため，<jar-file>タグには「../lib/myEntities.jar」と指定します。

(c)　パシステンスクラスのリストを明示的に指定する

<class>タグを使用すると，パシステンスクラスのリストを明示的に指定できます。マッピング情報は，指定されたクラスに付加されたアノテーションから取得されます。なお，<class>タグは，<mapping-file>タグや<jar-file>タグと併用することもできます。

(d)　アノテーションを付加したパシステンスクラスを永続化ユニットのルートに配置する

永続化ユニットのルートからは，@Entity，@Embeddable，@MappedSuperclassの付加されたパシステンスクラスが自動的に検索されます。マッピング情報はクラスに付加されたアノテーションから取得されます。永続化ユニットのルートに配置したアノテーションの付加されたクラスを永続化ユニットに加えたくない場合には，<exclude-unlisted-classes>タグを指定しておく必要があります。