public class Persistence
extends java.lang.Object
EntityManagerFactory
in Java SE environments. It may also be used to cause schema
generation to occur.
The Persistence
class is available in a Jakarta EE
container environment as well; however, support for the Java SE
bootstrapping APIs is not required in container environments.
The Persistence
class is used to obtain a PersistenceUtil
instance in both
Jakarta EE and Java SE environments.
Modifier and Type | Field and Description |
---|---|
static java.lang.String |
PERSISTENCE_PROVIDER
Deprecated.
TODO: Either change TCK reference to PERSISTENCE_PROVIDER field to expect
"jakarta.persistence.spi.PersistenceProvider" or remove PERSISTENCE_PROVIDER field and also update TCK signature
tests.
|
protected static java.util.Set<PersistenceProvider> |
providers
Deprecated.
|
Constructor and Description |
---|
Persistence() |
Modifier and Type | Method and Description |
---|---|
static EntityManagerFactory |
createEntityManagerFactory(java.lang.String persistenceUnitName)
Create and return an EntityManagerFactory for the named
persistence unit.
|
static EntityManagerFactory |
createEntityManagerFactory(java.lang.String persistenceUnitName,
java.util.Map properties)
Create and return an EntityManagerFactory for the named persistence unit
using the given properties.
|
static void |
generateSchema(java.lang.String persistenceUnitName,
java.util.Map map)
Create database schemas and/or tables and/or create DDL
scripts as determined by the supplied properties.
|
static PersistenceUtil |
getPersistenceUtil()
Return the PersistenceUtil instance
|
@Deprecated public static final java.lang.String PERSISTENCE_PROVIDER
@Deprecated protected static final java.util.Set<PersistenceProvider> providers
public static EntityManagerFactory createEntityManagerFactory(java.lang.String persistenceUnitName)
persistenceUnitName
- the name of the persistence unitpublic static EntityManagerFactory createEntityManagerFactory(java.lang.String persistenceUnitName, java.util.Map properties)
persistenceUnitName
- the name of the persistence unitproperties
- Additional properties to use when creating the factory.
These properties may include properties to control
schema generation. The values of these properties override
any values that may have been configured elsewhere.public static void generateSchema(java.lang.String persistenceUnitName, java.util.Map map)
Called when schema generation is to occur as a separate phase from creation of the entity manager factory.
persistenceUnitName
- the name of the persistence unitmap
- properties for schema generation; these may
also contain provider-specific properties. The
value of these properties override any values that
may have been configured elsewhere..PersistenceException
- if insufficient or inconsistent
configuration information is provided or if schema
generation otherwise fails.public static PersistenceUtil getPersistenceUtil()