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

ExtendedEntityManagerCreator()

Method Summary

static javax.persistence.EntityManager	createApplicationManagedEntityManager(javax.persistence.EntityManager rawEntityManager, EntityManagerFactoryInfo emfInfo) Create an EntityManager that can join transactions with the joinTransaction() method, but is not automatically managed by the container.
static javax.persistence.EntityManager	createApplicationManagedEntityManager(javax.persistence.EntityManager rawEntityManager, EntityManagerPlusOperations plusOperations) Create an EntityManager that can join transactions with the joinTransaction() method, but is not automatically managed by the container.
static javax.persistence.EntityManager	createApplicationManagedEntityManager(javax.persistence.EntityManager rawEntityManager, EntityManagerPlusOperations plusOperations, PersistenceExceptionTranslator exceptionTranslator) Create an EntityManager that can join transactions with the joinTransaction() method, but is not automatically managed by the container.
static javax.persistence.EntityManager	createContainerManagedEntityManager(javax.persistence.EntityManager rawEntityManager, EntityManagerFactoryInfo emfInfo) Create an EntityManager that automatically joins transactions on each operation in a transaction.
static javax.persistence.EntityManager	createContainerManagedEntityManager(javax.persistence.EntityManager rawEntityManager, EntityManagerPlusOperations plusOperations) Create an EntityManager that automatically joins transactions on each operation in a transaction.
static javax.persistence.EntityManager	createContainerManagedEntityManager(javax.persistence.EntityManager rawEntityManager, EntityManagerPlusOperations plusOperations, PersistenceExceptionTranslator exceptionTranslator) Create an EntityManager that automatically joins transactions on each operation in a transaction.
static javax.persistence.EntityManager	createContainerManagedEntityManager(javax.persistence.EntityManagerFactory emf) Create an EntityManager that automatically joins transactions on each operation in a transaction.
static javax.persistence.EntityManager	createContainerManagedEntityManager(javax.persistence.EntityManagerFactory emf, Map properties) Create an EntityManager that automatically joins transactions on each operation in a transaction.

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 javax.persistence.EntityManager createApplicationManagedEntityManager(javax.persistence.EntityManager rawEntityManager,
                                                                                    EntityManagerPlusOperations plusOperations)

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

Parameters:

rawEntityManager - raw EntityManager

plusOperations - an implementation of the EntityManagerPlusOperations interface, if those operations should be exposed (may be null)

Returns:

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

createApplicationManagedEntityManager

public static javax.persistence.EntityManager createApplicationManagedEntityManager(javax.persistence.EntityManager rawEntityManager,
                                                                                    EntityManagerPlusOperations plusOperations,
                                                                                    PersistenceExceptionTranslator exceptionTranslator)

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

Parameters:

rawEntityManager - raw EntityManager

plusOperations - an implementation of the EntityManagerPlusOperations interface, if those operations should be exposed (may be null)

exceptionTranslator - the exception translator to use for translating JPA commit/rollback exceptions during transaction synchronization (may be null)

Returns:

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

createApplicationManagedEntityManager

public static javax.persistence.EntityManager createApplicationManagedEntityManager(javax.persistence.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 EntityManagerPlusOperations and PersistenceUnitInfo from

Returns:

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

createContainerManagedEntityManager

public static javax.persistence.EntityManager createContainerManagedEntityManager(javax.persistence.EntityManager rawEntityManager,
                                                                                  EntityManagerPlusOperations plusOperations)

Create an EntityManager that automatically joins transactions on each operation in a transaction.

Parameters:

rawEntityManager - raw EntityManager

plusOperations - an implementation of the EntityManagerPlusOperations interface, if those operations should be exposed (may be null)

Returns:

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

createContainerManagedEntityManager

public static javax.persistence.EntityManager createContainerManagedEntityManager(javax.persistence.EntityManager rawEntityManager,
                                                                                  EntityManagerPlusOperations plusOperations,
                                                                                  PersistenceExceptionTranslator exceptionTranslator)

Create an EntityManager that automatically joins transactions on each operation in a transaction.

Parameters:

rawEntityManager - raw EntityManager

plusOperations - an implementation of the EntityManagerPlusOperations interface, if those operations should be exposed (may be null)

exceptionTranslator - the exception translator to use for translating JPA commit/rollback exceptions during transaction synchronization (may be null)

Returns:

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

createContainerManagedEntityManager

public static javax.persistence.EntityManager createContainerManagedEntityManager(javax.persistence.EntityManager rawEntityManager,
                                                                                  EntityManagerFactoryInfo emfInfo)

Create an EntityManager that automatically joins transactions on each operation in a transaction.

Parameters:

rawEntityManager - raw EntityManager

emfInfo - the EntityManagerFactoryInfo to obtain the EntityManagerPlusOperations and PersistenceUnitInfo from

Returns:

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

createContainerManagedEntityManager

public static javax.persistence.EntityManager createContainerManagedEntityManager(javax.persistence.EntityManagerFactory emf)

Create an EntityManager that automatically joins transactions on each operation in a transaction.

Parameters:

emf - the EntityManagerFactory to create the EntityManager with. If this implements the EntityManagerFactoryInfo interface, appropriate handling of the native EntityManagerFactory and available EntityManagerPlusOperations will automatically apply.

Returns:

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

See Also:

EntityManagerFactory.createEntityManager()

createContainerManagedEntityManager

public static javax.persistence.EntityManager createContainerManagedEntityManager(javax.persistence.EntityManagerFactory emf,
                                                                                  Map properties)

Create an EntityManager that automatically joins transactions on each operation in a transaction.

Parameters:

emf - the EntityManagerFactory to create the EntityManager with. If this implements the EntityManagerFactoryInfo interface, appropriate handling of the native EntityManagerFactory and available EntityManagerPlusOperations will automatically apply.

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)