Scott Marlow created WFLY-11233:
-----------------------------------
Summary: allow EntityManager caching in the JPA container
Key: WFLY-11233
URL:
https://issues.jboss.org/browse/WFLY-11233
Project: WildFly
Issue Type: Enhancement
Components: JPA / Hibernate
Reporter: Scott Marlow
It could be interesting to see if caching EntityManager instances (per
EntityManagerFactory) could improve performance for applications, that could benefit from
that.
The JPA 2.2 specification mentions the below, pay particular attention to the text
"whether entity manager instances are sometimes reused" in section 7.8.2:
{quote}
7.8 Requirements on the Container
7.8.1 Application-managed Persistence Contexts
When application-managed persistence contexts are used, the container must instantiate the
entity manager factory and expose it to the application via JNDI. The container might use
internal APIs to create the entity manager factory, or it might use the
PersistenceProvider.createContainerEntityManagerFactory method. However, the container is
required to support third-party persistence providers, and in this case the container must
use the PersistenceProvider.createContainerEntityManagerFactory method to create the
entity manager factory and the EntityManagerFactory.close method to destroy the entity
manager factory prior to shutdown (if it has not been previously closed by the
application).
7.8.2 Container Managed Persistence Contexts
The container is responsible for managing the lifecycle of container-managed persistence
contexts, for injecting EntityManager references into web components and session bean and
message-driven bean components, and for making EntityManager references available to
direct lookups in JNDI. When operating with a third-party persistence provider, the
container uses the contracts defined in section 7.9 to create and destroy
container-managed persistence contexts. It is undefined whether a new entity manager
instance is created for every persistence context, or whether entity manager instances are
sometimes reused. Exactly how the container maintains the association between persistence
context and JTA transaction is not defined. If a persistence context is already associated
with a JTA transaction, the container uses that persistence context for subsequent
invocations within the scope of that transaction, according to the semantics for
persistence context propagation defined in section 7.6.4.
7.9 Runtime Contracts between the Container and Persistence Provider
This section describes contracts between the container and the persistence provider for
the pluggability of third-party persistence providers. Containers are required to support
these pluggability contracts. [87]
7.9.1 Container Responsibilities
For the management of a transaction-scoped persistence context, if there is no
EntityManager already associated with the JTA transaction:
* The container creates a new entity manager by calling
EntityManagerFactory.createEntityManager when the first invocation of an entity manager
with PersistenceContextType.TRANSACTION occurs within the scope of a business method
executing in the JTA transaction.
* After the JTA transaction has completed (either by transaction commit or rollback), the
container closes the entity manager by calling EntityManager.close. [88] Note that the JTA
transaction may rollback in a background thread (e.g., as a result of transaction
timeout), in which case the container should arrange for the entity manager to be closed
but the EntityManager.close method should not be concurrently invoked while the
application is in an EntityManager invocation.
The container must throw the TransactionRequiredException if a transaction-scoped
persistence context is used and the EntityManager persist, remove, merge, or refresh
method is invoked when no transaction is active.
For stateful session beans with extended persistence contexts:
* The container creates an entity manager by calling
EntityManagerFactory.createEntityManager when a stateful session bean is created that
declares a dependency on an entity manager with PersistenceContextType.EXTENDED. (See
section 7.6.3).
--
This message was sent by Atlassian Jira
(v7.12.1#712002)