org.springframework.orm.jpa

Class ExtendedEntityManagerCreator

java.lang.Object

org.springframework.orm.jpa.ExtendedEntityManagerCreator

public abstract class ExtendedEntityManagerCreator
extends Object

Factory for dynamic EntityManager proxies that follow the JPA spec's semantics for "extended" EntityManagers.

Supports explicit joining of a transaction through the joinTransaction() method ("application-managed extended EntityManager") as well as automatic joining on each operation ("container-managed extended EntityManager").

Since:

2.0

Author:

Rod Johnson, Juergen Hoeller

Constructor Summary

Constructors

Constructor and Description
ExtendedEntityManagerCreator()

Method Summary

Modifier and Type	Method and Description
static EntityManager	createApplicationManagedEntityManager(EntityManager rawEntityManager, EntityManagerFactoryInfo emfInfo) Create an EntityManager that can join transactions with the joinTransaction() method, but is not automatically managed by the container.
static EntityManager	createApplicationManagedEntityManager(EntityManager rawEntityManager, EntityManagerFactoryInfo emfInfo, boolean synchronizedWithTransaction) Create an EntityManager that can join transactions with the joinTransaction() method, but is not automatically managed by the container.
static EntityManager	createContainerManagedEntityManager(EntityManager rawEntityManager, EntityManagerFactoryInfo emfInfo) Create an EntityManager whose lifecycle is managed by the container and which automatically joins a transaction when being invoked within its scope.
static EntityManager	createContainerManagedEntityManager(EntityManagerFactory emf) Create an EntityManager whose lifecycle is managed by the container and which automatically joins a transaction when being invoked within its scope.
static EntityManager	createContainerManagedEntityManager(EntityManagerFactory emf, Map<?,?> properties) Create an EntityManager whose lifecycle is managed by the container and which automatically joins a transaction when being invoked within its scope.
static EntityManager	createContainerManagedEntityManager(EntityManagerFactory emf, Map<?,?> properties, boolean synchronizedWithTransaction) Create an EntityManager whose lifecycle is managed by the container and which may automatically join a transaction when being invoked within its scope.

Methods inherited from class java.lang.Object

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

Constructor Detail

ExtendedEntityManagerCreator

public ExtendedEntityManagerCreator()

Method Detail

createApplicationManagedEntityManager

public static EntityManager createApplicationManagedEntityManager(EntityManager rawEntityManager,
                                                                  EntityManagerFactoryInfo emfInfo)

Create an EntityManager that can join transactions with the joinTransaction() method, but is not automatically managed by the container.

Parameters:

rawEntityManager - raw EntityManager

emfInfo - the EntityManagerFactoryInfo to obtain the JpaDialect and PersistenceUnitInfo from

Returns:

an application-managed EntityManager that can join transactions but does not participate in them automatically

createApplicationManagedEntityManager

public static EntityManager createApplicationManagedEntityManager(EntityManager rawEntityManager,
                                                                  EntityManagerFactoryInfo emfInfo,
                                                                  boolean synchronizedWithTransaction)

Create an EntityManager that can join transactions with the joinTransaction() method, but is not automatically managed by the container.

Parameters:

rawEntityManager - raw EntityManager

emfInfo - the EntityManagerFactoryInfo to obtain the JpaDialect and PersistenceUnitInfo from

synchronizedWithTransaction - whether to automatically join ongoing transactions (according to the JPA 2.1 SynchronizationType rules)

Returns:

an application-managed EntityManager that can join transactions but does not participate in them automatically

createContainerManagedEntityManager

public static EntityManager createContainerManagedEntityManager(EntityManager rawEntityManager,
                                                                EntityManagerFactoryInfo emfInfo)

Create an EntityManager whose lifecycle is managed by the container and which automatically joins a transaction when being invoked within its scope.

Parameters:

rawEntityManager - raw EntityManager

emfInfo - the EntityManagerFactoryInfo to obtain the JpaDialect and PersistenceUnitInfo from

Returns:

a container-managed EntityManager that will automatically participate in any managed transaction

createContainerManagedEntityManager

public static EntityManager createContainerManagedEntityManager(EntityManagerFactory emf)

Create an EntityManager whose lifecycle is managed by the container and which automatically joins a transaction when being invoked within its scope.

Parameters:

emf - the EntityManagerFactory to create the EntityManager with. If this implements the EntityManagerFactoryInfo interface, the corresponding JpaDialect and PersistenceUnitInfo will be detected accordingly.

Returns:

a container-managed EntityManager that will automatically participate in any managed transaction

See Also:

EntityManagerFactory.createEntityManager()

createContainerManagedEntityManager

public static EntityManager createContainerManagedEntityManager(EntityManagerFactory emf,
                                                                Map<?,?> properties)

Create an EntityManager whose lifecycle is managed by the container and which automatically joins a transaction when being invoked within its scope.

Parameters:

emf - the EntityManagerFactory to create the EntityManager with. If this implements the EntityManagerFactoryInfo interface, the corresponding JpaDialect and PersistenceUnitInfo will be detected accordingly.

properties - the properties to be passed into the createEntityManager call (may be null)

Returns:

a container-managed EntityManager that will automatically participate in any managed transaction

See Also:

EntityManagerFactory.createEntityManager(java.util.Map)

createContainerManagedEntityManager

public static EntityManager createContainerManagedEntityManager(EntityManagerFactory emf,
                                                                Map<?,?> properties,
                                                                boolean synchronizedWithTransaction)

Create an EntityManager whose lifecycle is managed by the container and which may automatically join a transaction when being invoked within its scope.

Parameters:

emf - the EntityManagerFactory to create the EntityManager with. If this implements the EntityManagerFactoryInfo interface, the corresponding JpaDialect and PersistenceUnitInfo will be detected accordingly.

properties - the properties to be passed into the createEntityManager call (may be null)

synchronizedWithTransaction - whether to automatically join ongoing transactions (according to the JPA 2.1 SynchronizationType rules)

Returns:

a container-managed EntityManager that expects container-driven lifecycle management but may opt out of automatic transaction synchronization

See Also:

EntityManagerFactory.createEntityManager(java.util.Map)