パッケージ jakarta.persistence

クラス Persistence

  • public class Persistence
extends ObjectSE
    Java SE 環境で EntityManagerFactory を取得するために使用されるブートストラップクラス。また、スキーマの生成を引き起こすためにも使用できます。

    Persistence クラスは、Jakarta EE コンテナー環境でも使用できます。ただし、コンテナー環境では、Java SE ブートストラップ API のサポートは必要ありません。

    Persistence クラスは、Jakarta EE 環境と Java SE 環境の両方で PersistenceUtil インスタンスを取得するために使用されます。

    導入:
    1.0

    • フィールドの詳細

      • PERSISTENCE_PROVIDER

        @DeprecatedSE
public static final StringSE PERSISTENCE_PROVIDER
        使用すべきではありません。
        TODO: TCK 参照を PERSISTENCE_PROVIDER フィールドに変更して "jakarta.persistence.spi.PersistenceProvider" を予期するか、PERSISTENCE_PROVIDER フィールドを削除して TCK 署名テストを更新します。
        この最後の文字列は非推奨であり、削除する必要があり、TCK の下位互換性のためにのみここにあります
        導入:
        1.0
        関連事項:
        定数フィールド値

      • providers

        @DeprecatedSE
protected static final SetSE<PersistenceProvider> providers
        使用すべきではありません。
        このインスタンス変数は非推奨であり、削除する必要があり、TCK の下位互換性のためにここにのみあります
        導入:
        1.0

    • コンストラクターの詳細

      • Persistence

        public Persistence()

    • メソッドの詳細

      • createEntityManagerFactory

        public static EntityManagerFactory createEntityManagerFactory​(StringSE persistenceUnitName)
        名前付き永続性ユニットの EntityManagerFactory を作成して返します。
        パラメーター:
        persistenceUnitName - 永続性ユニットの名前
        戻り値:
        指定された永続性ユニットに従って構成された EntityManagers を作成するファクトリ

      • createEntityManagerFactory

        public static EntityManagerFactory createEntityManagerFactory​(StringSE persistenceUnitName,
                                                              MapSE properties)
        指定されたプロパティを使用して、名前付き永続性ユニットの EntityManagerFactory を作成して返します。
        パラメーター:
        persistenceUnitName - 永続性ユニットの名前
        properties - ファクトリを作成するときに使用する追加のプロパティ。これらのプロパティには、スキーマ生成を制御するプロパティが含まれる場合があります。これらのプロパティの値は、他の場所で構成されている可能性のある値を上書きします。
        戻り値:
        指定された永続性ユニットに従って構成された EntityManagers を作成するファクトリ。

      • generateSchema

        public static void generateSchema​(StringSE persistenceUnitName,
                                  MapSE map)
        提供されたプロパティによって決定されるように、データベーススキーマやテーブルを作成し、DDL スクリプトを作成します。

        スキーマの生成がエンティティマネージャーファクトリの作成とは別のフェーズとして行われるときに呼び出されます。

        パラメーター:
        persistenceUnitName - 永続性ユニットの名前
        map - スキーマ生成のプロパティ。これらには、プロバイダー固有のプロパティが含まれる場合もあります。これらのプロパティの値は、他の場所で構成されている可能性のある値を上書きします。
        例外:
        PersistenceException - 提供された構成情報が不十分または矛盾している場合、またはスキーマの生成が失敗した場合。
        導入:
        2.1

      • getPersistenceUtil

        public static PersistenceUtil getPersistenceUtil()
        PersistenceUtil インスタンスを返す
        戻り値:
        PersistenceUtil インスタンス
        導入:
        2.0