persistence.xml ファイルの管理

プロジェクトを作成するとき、Eclipse は META-INF¥persistence.xml ファイルをプロジェクト・ディレクトリーに作成します。

JPA プロジェクトを作成するとき (新規 JPA プロジェクトの作成を参照)、スタブ persistence.xml ファイルを META-INF ディレクトリーに作成できます。このファイルは、XML エディター (参照) または persistence.xml エディターのいずれかを使用して管理できます。


注:

JPA 実装 (EclipseLink など) によっては、persistence.xml エディターで以下の追加のページを使用できる場合があります。
  • カスタマイズ

    このページは、変更の追跡およびセッション・カスタマイザー関連のプロパティーの定義に使用します。

  • キャッシング

    このページはキャッシング・プロパティーの定義に使用します。

  • ロギング

    このページは、ロギング・プロパティーの定義に使用します。

  • オプション

    このページは、セッションおよびターゲット・データベースのプロパティーの定義に使用します。

  • スキーマ生成

    このページは DDL 関連のプロパティーの定義に使用します。

EclipseLink の JPA 実装を使用するプロジェクトの場合、「接続」ページには JDBC 接続プールのプロパティーも含まれます。

汎用プラットフォームを使用するプロジェクトの場合、 「一般」、「接続」、「プロパティー」、「ソース」ページのみが使用可能です。


persistence.xml エディターを使用する手順は、次のとおりです。

  1. peristence.xml ファイルを開きます。エディターの「一般」ページが表示されます。

  2. 一般」ページを使用して、persistence.xml ファイルの <persistent-unit> 関連の属性と、<provider> および <class> エレメント (次のテーブルで説明) を定義します。


    ヒント:

    persistence.xml エディターの「ソース」ページでは、未加工の XML ファイルを表示および編集できます。

    プロパティー 説明 定義されているエレメント
    名前 パーシスタンス・ユニットの名前を入力します。 <persistence-unit name = "<Name>">
    パーシスタンス・プロバイダー パーシスタンス・プロバイダーの名前を入力します。 <provider>
    説明 このパーシスタンス・ユニットの説明を入力します。これはオプション・プロパティーです。 <description>
    管理クラス パーシスタンス・ユニットを介して管理されるクラスを追加または削除します。 <class>
      リストされていないクラスを除外   これを選択すると、すべての注釈付きエンティティー・クラスがパーシスタンス・ユニットのルートに含まれます。 <exclude-unlisted-classes>
    XML マッピング・ファイル   パーシスタンス・ユニットを介して管理されるクラスを定義する、Object/Relational マッピング XML ファイルを追加または削除します。 <mapping-file>
    JAR ファイル 追加の JAR ファイルおよびライブラリーの追加または削除

  3. 接続」ページを使用して、以下のように <jta-data-source> および <non-jta-data-source> エレメントを定義します。

    パーシスタンス・プロバイダーが使用する JTA (Java トランザクション API) のソースを構成する手順は、以下のとおりです。

    1. 「トランザクション・タイプ」のリストから「JTA」を選択します。

    2. データ・ソースのグローバル JNDI 名を入力します。

    非 JTA データ・ソースを構成する手順は、以下のとおりです。

    1. 「トランザクション・タイプ」のリストから「リソース・ローカル」を選択します。

    2. データ・ソースのグローバル JNDI 名を入力します。


      注:

      コンテナーの提供するデータ・ソースを使用するには、Default() を選択します。

    汎用プラットフォームを使用しているプロジェクトの場合、EclipseLink 接続プール・ドライバー、接続プール・ドライバー、URL、ユーザー名、およびパスワードを定義することもできます。

  4. 「プロパティー」ページのテーブルを使用して、ベンダー固有の <properties> エレメントを設定します。

    <property> エレメントを追加する手順は、以下のとおりです。

    1. 追加」をクリックします。

    2. テーブルの「名前」および「値」フィールドを使用して、<property> エレメントの <name> および <value> 属性を入力します。

    <property> エレメントを削除するには、テーブルで定義済みプロパティーを選択し、「削除」をクリックします。


    注:

    プロジェクトが EclipseLink プラットフォームを使用している場合は、「接続」ページに JDBC 接続プーリングのパラメーターも含まれます。

関連リファレンス

persistence.xml エディター

 

関連タスク

クラスの同期化

 

関連概念

persistence.xml ファイル