Interface EntityManagerFactory
-
- All Known Subinterfaces:
JpaEntityManagerFactory
public interface EntityManagerFactoryInterface used to interact with the entity manager factory for the persistence unit.When the application has finished using the entity manager factory, and/or at application shutdown, the application should close the entity manager factory. Once an
EntityManagerFactoryhas been closed, all its entity managers are considered to be in the closed state.- Since:
- 1.0
-
-
Method Summary
All Methods Instance Methods Abstract Methods Modifier and Type Method Description <T> voidaddNamedEntityGraph(java.lang.String graphName, EntityGraph<T> entityGraph)Add a named copy of the EntityGraph to the EntityManagerFactory.voidaddNamedQuery(java.lang.String name, Query query)Define the query, typed query, or stored procedure query as a named query such that future query objects can be created from it using thecreateNamedQueryorcreateNamedStoredProcedureQuerymethod.voidclose()Close the factory, releasing any resources that it holds.EntityManagercreateEntityManager()Create a new application-managedEntityManager.EntityManagercreateEntityManager(java.util.Map map)Create a new application-managedEntityManagerwith the specified Map of properties.EntityManagercreateEntityManager(SynchronizationType synchronizationType)Create a new JTA application-managedEntityManagerwith the specified synchronization type.EntityManagercreateEntityManager(SynchronizationType synchronizationType, java.util.Map map)Create a new JTA application-managedEntityManagerwith the specified synchronization type and map of properties.CachegetCache()Access the cache that is associated with the entity manager factory (the "second level cache").CriteriaBuildergetCriteriaBuilder()Return an instance ofCriteriaBuilderfor the creation ofCriteriaQueryobjects.MetamodelgetMetamodel()Return an instance ofMetamodelinterface for access to the metamodel of the persistence unit.PersistenceUnitUtilgetPersistenceUnitUtil()Return interface providing access to utility methods for the persistence unit.java.util.Map<java.lang.String,java.lang.Object>getProperties()Get the properties and associated values that are in effect for the entity manager factory.booleanisOpen()Indicates whether the factory is open.<T> Tunwrap(java.lang.Class<T> cls)Return an object of the specified type to allow access to the provider-specific API.
-
-
-
Method Detail
-
createEntityManager
EntityManager createEntityManager()
Create a new application-managedEntityManager. This method returns a newEntityManagerinstance each time it is invoked. TheisOpenmethod will return true on the returned instance.- Returns:
- entity manager instance
- Throws:
java.lang.IllegalStateException- if the entity manager factory has been closed
-
createEntityManager
EntityManager createEntityManager(java.util.Map map)
Create a new application-managedEntityManagerwith the specified Map of properties. This method returns a newEntityManagerinstance each time it is invoked. TheisOpenmethod will return true on the returned instance.- Parameters:
map- properties for entity manager- Returns:
- entity manager instance
- Throws:
java.lang.IllegalStateException- if the entity manager factory has been closed
-
createEntityManager
EntityManager createEntityManager(SynchronizationType synchronizationType)
Create a new JTA application-managedEntityManagerwith the specified synchronization type. This method returns a newEntityManagerinstance each time it is invoked. TheisOpenmethod will return true on the returned instance.- Parameters:
synchronizationType- how and when the entity manager should be synchronized with the current JTA transaction- Returns:
- entity manager instance
- Throws:
java.lang.IllegalStateException- if the entity manager factory has been configured for resource-local entity managers or is closed- Since:
- 2.1
-
createEntityManager
EntityManager createEntityManager(SynchronizationType synchronizationType, java.util.Map map)
Create a new JTA application-managedEntityManagerwith the specified synchronization type and map of properties. This method returns a newEntityManagerinstance each time it is invoked. TheisOpenmethod will return true on the returned instance.- Parameters:
synchronizationType- how and when the entity manager should be synchronized with the current JTA transactionmap- properties for entity manager- Returns:
- entity manager instance
- Throws:
java.lang.IllegalStateException- if the entity manager factory has been configured for resource-local entity managers or is closed- Since:
- 2.1
-
getCriteriaBuilder
CriteriaBuilder getCriteriaBuilder()
Return an instance ofCriteriaBuilderfor the creation ofCriteriaQueryobjects.- Returns:
- CriteriaBuilder instance
- Throws:
java.lang.IllegalStateException- if the entity manager factory has been closed- Since:
- 2.0
-
getMetamodel
Metamodel getMetamodel()
Return an instance ofMetamodelinterface for access to the metamodel of the persistence unit.- Returns:
- Metamodel instance
- Throws:
java.lang.IllegalStateException- if the entity manager factory has been closed- Since:
- 2.0
-
isOpen
boolean isOpen()
Indicates whether the factory is open. Returns true until the factory has been closed.- Returns:
- boolean indicating whether the factory is open
-
close
void close()
Close the factory, releasing any resources that it holds. After a factory instance has been closed, all methods invoked on it will throw theIllegalStateException, except forisOpen, which will return false. Once anEntityManagerFactoryhas been closed, all its entity managers are considered to be in the closed state.- Throws:
java.lang.IllegalStateException- if the entity manager factory has been closed
-
getProperties
java.util.Map<java.lang.String,java.lang.Object> getProperties()
Get the properties and associated values that are in effect for the entity manager factory. Changing the contents of the map does not change the configuration in effect.- Returns:
- properties
- Throws:
java.lang.IllegalStateException- if the entity manager factory has been closed- Since:
- 2.0
-
getCache
Cache getCache()
Access the cache that is associated with the entity manager factory (the "second level cache").- Returns:
- instance of the
Cacheinterface or null if no cache is in use - Throws:
java.lang.IllegalStateException- if the entity manager factory has been closed- Since:
- 2.0
-
getPersistenceUnitUtil
PersistenceUnitUtil getPersistenceUnitUtil()
Return interface providing access to utility methods for the persistence unit.- Returns:
PersistenceUnitUtilinterface- Throws:
java.lang.IllegalStateException- if the entity manager factory has been closed- Since:
- 2.0
-
addNamedQuery
void addNamedQuery(java.lang.String name, Query query)Define the query, typed query, or stored procedure query as a named query such that future query objects can be created from it using thecreateNamedQueryorcreateNamedStoredProcedureQuerymethod.Any configuration of the query object (except for actual parameter binding) in effect when the named query is added is retained as part of the named query definition. This includes configuration information such as max results, hints, flush mode, lock mode, result set mapping information, and information about stored procedure parameters.
When the query is executed, information that can be set by means of the query APIs can be overridden. Information that is overridden does not affect the named query as registered with the entity manager factory, and thus does not affect subsequent query objects created from it by means of the
createNamedQueryorcreateNamedStoredProcedureQuerymethod.If a named query of the same name has been previously defined, either statically via metadata or via this method, that query definition is replaced.
- Parameters:
name- name for the queryquery- Query, TypedQuery, or StoredProcedureQuery object- Since:
- 2.1
-
unwrap
<T> T unwrap(java.lang.Class<T> cls)
Return an object of the specified type to allow access to the provider-specific API. If the provider's EntityManagerFactory implementation does not support the specified class, the PersistenceException is thrown.- Parameters:
cls- the class of the object to be returned. This is normally either the underlying EntityManagerFactory implementation class or an interface that it implements.- Returns:
- an instance of the specified class
- Throws:
PersistenceException- if the provider does not support the call- Since:
- 2.1
-
addNamedEntityGraph
<T> void addNamedEntityGraph(java.lang.String graphName, EntityGraph<T> entityGraph)Add a named copy of the EntityGraph to the EntityManagerFactory. If an entity graph with the same name already exists, it is replaced.- Parameters:
graphName- name for the entity graphentityGraph- entity graph- Since:
- 2.1
-
-