javax.persistence

クラス Persistence

java.lang.Object

javax.persistence.Persistence

public class Persistence
extends java.lang.Object

Java SE環境でEntityManagerFactoryを得るために使用されるブートストラップクラスです。 また、スキーマの生成を行わせるために使用することもできます。

PersistenceクラスはJava EEコンテナ環境でも使用できます。 しかしながらコンテナ環境ではJava SEブートストラップAPIのサポートは必須ではありません。

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

導入されたバージョン:

Java Persistence 1.0

フィールドのサマリー

フィールド

修飾子とタイプ	フィールドと説明
static java.lang.String	PERSISTENCE_PROVIDER 非推奨です。
protected static java.util.Set<PersistenceProvider>	providers 非推奨です。

コンストラクタのサマリー

コンストラクタ

コンストラクタと説明
Persistence()

メソッドのサマリー

修飾子とタイプ	メソッドと説明
static EntityManagerFactory	createEntityManagerFactory(java.lang.String persistenceUnitName) 指定された名前の永続化ユニットのためのEntityManagerFactoryを作成し、返します。
static EntityManagerFactory	createEntityManagerFactory(java.lang.String persistenceUnitName, java.util.Map properties) 与えられたプロパティを使用した指定された名前の永続化ユニットのためのEntityManagerFactoryを作成し、返します。
static void	generateSchema(java.lang.String persistenceUnitName, java.util.Map map) 指定されたプロパティから決定されるデータベーススキーマと/もしくはテーブルを作成するか/もしくはDDLスクリプトを作成します。
static PersistenceUtil	getPersistenceUtil() PersistenceUtilのインスタンスを返します。

クラスから継承されたメソッド java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

フィールドの詳細

PERSISTENCE_PROVIDER

@Deprecated
public static final java.lang.String PERSISTENCE_PROVIDER

非推奨です。

このfinalな文字列は非推奨で、削除されるべきです。これはTCK下位互換のためにのみ存在します。

導入されたバージョン:

Java Persistence 1.0

関連項目:

定数フィールド値

providers

@Deprecated
protected static final java.util.Set<PersistenceProvider> providers

非推奨です。

このインスタンス変数は非推奨で、削除されるべきです。これはTCK下位互換のためにのみ存在します。

導入されたバージョン:

Java Persistence 1.0

コンストラクタの詳細

Persistence

public Persistence()

メソッドの詳細

createEntityManagerFactory

public static EntityManagerFactory createEntityManagerFactory(java.lang.String persistenceUnitName)

指定された名前の永続化ユニットのためのEntityManagerFactoryを作成し、返します。

パラメータ:

persistenceUnitName - 永続化ユニットの名前

戻り値:

指定された永続化ユニットに従って構成されたEntityManagerを作成するファクトリー

createEntityManagerFactory

public static EntityManagerFactory createEntityManagerFactory(java.lang.String persistenceUnitName,
                                                              java.util.Map properties)

与えられたプロパティを使用した指定された名前の永続化ユニットのためのEntityManagerFactoryを作成し、返します。

パラメータ:

persistenceUnitName - 永続化ユニットの名前

properties - ファクトリーを作成する時に使用される追加のプロパティ。 このプロパティはスキーマ生成のコントロールのためのプロパティを含めることができます。 このプロパティの値は他の場所で設定されている値を上書きします。

戻り値:

指定された永続化ユニットに従って設定されたEntityManagerを作成するファクトリー

generateSchema

public static void generateSchema(java.lang.String persistenceUnitName,
                                  java.util.Map map)

指定されたプロパティから決定されるデータベーススキーマと/もしくはテーブルを作成するか/もしくはDDLスクリプトを作成します。

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

パラメータ:

persistenceUnitName - 永続化ユニットの名前

map - スキーマ生成のプロパティ、それらはプロバイダ固有のプロパティを含めることができます。 このプロパティの値は他の場所で設定されている値を上書きします。

例外:

PersistenceException - 提供された構成情報が不十分か矛盾があった場合、またはスキーマ生成が失敗した場合

導入されたバージョン:

Java Persistence 2.1

getPersistenceUtil

public static PersistenceUtil getPersistenceUtil()

PersistenceUtilのインスタンスを返します。

戻り値:

PersistenceUtilのインスタンス

導入されたバージョン:

Java Persistence 2.0