javax.persistence.EntityManagerFactory - JPA interface
javax.persistence
Interface EntityManagerFactory
Interface 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 EntityManagerFactory has been closed, all its entity managers are considered to be in the closed state.
- Since:
- JPA 1.0
Learn how to use EntityManagerFactory in Chapter 3 of the ObjectDB/JPA manual.
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 the
IllegalStateException, except for isOpen, which will return false. Once an EntityManagerFactory has been closed, all its entity managers are considered to be in the closed state. - Throws:
-
IllegalStateException- if the entity manager factory has been closed
- Since:
- JPA 1.0
Create a new application-managed
EntityManager. This method returns a new EntityManager instance each time it is invoked. The isOpen method will return true on the returned instance. - Returns:
- entity manager instance
- Throws:
-
IllegalStateException- if the entity manager factory has been closed
- Since:
- JPA 1.0
EntityManager createEntityManager(Map map)
Create a new application-managed
EntityManager with the specified Map of properties. This method returns a new EntityManager instance each time it is invoked. The isOpen method will return true on the returned instance. - Parameters:
-
map- properties for entity manager
- Returns:
- entity manager instance
- Throws:
-
IllegalStateException- if the entity manager factory has been closed
- Since:
- JPA 1.0
Access the cache that is associated with the entity manager factory (the "second level cache").
- Returns:
- instance of the
Cacheinterface
- Throws:
-
IllegalStateException- if the entity manager factory has been closed
- Since:
- JPA 2.0
Return an instance of
CriteriaBuilder for the creation of CriteriaQuery objects. - Returns:
- CriteriaBuilder instance
- Throws:
-
IllegalStateException- if the entity manager factory has been closed
- Since:
- JPA 2.0
Return an instance of
Metamodel interface for access to the metamodel of the persistence unit. - Returns:
- Metamodel instance
- Throws:
-
IllegalStateException- if the entity manager factory has been closed
- Since:
- JPA 2.0
Return interface providing access to utility methods for the persistence unit.
- Returns:
-
PersistenceUnitUtilinterface
- Throws:
-
IllegalStateException- if the entity manager factory has been closed
- Since:
- JPA 2.0
Map<String,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:
-
IllegalStateException- if the entity manager factory has been closed
- Since:
- JPA 2.0
boolean isOpen()
Indicates whether the factory is open. Returns true until the factory has been closed.
- Returns:
- boolean indicating whether the factory is open
- Since:
- JPA 1.0
