org.datanucleus.api.jpa

Class JPAEntityManagerFactory

java.lang.Object

org.datanucleus.api.jpa.JPAEntityManagerFactory

All Implemented Interfaces:

javax.persistence.EntityManagerFactory, javax.persistence.PersistenceUnitUtil, javax.persistence.PersistenceUtil

public class JPAEntityManagerFactory
extends Object
implements javax.persistence.EntityManagerFactory, javax.persistence.PersistenceUnitUtil

EntityManagerFactory implementation. Caches the "persistence-unit" MetaData information when encountered (in J2SE mode).

Field Summary

Fields

Modifier and Type	Field and Description
protected static org.datanucleus.util.Localiser	LOCALISER Localiser for messages.
static org.datanucleus.util.NucleusLogger	LOGGER Logger for enhancing.

Constructor Summary

Constructors

Constructor and Description
JPAEntityManagerFactory() Constructor.
JPAEntityManagerFactory(javax.persistence.spi.PersistenceUnitInfo unitInfo, Map overridingProps) Constructor when working in a J2EE environment.
JPAEntityManagerFactory(org.datanucleus.metadata.PersistenceUnitMetaData pumd, Map overridingProps) Convenience constructor to allow for dynamic persistence-unit creation.
JPAEntityManagerFactory(String unitName, Map overridingProps) Constructor when working in a J2SE environment.

Method Summary

Methods

Modifier and Type	Method and Description
protected void	assertIsClosed()
void	close() Method to close the factory.
javax.persistence.EntityManager	createEntityManager() Method to create an entity manager.
javax.persistence.EntityManager	createEntityManager(Map overridingProps) Method to create an entity manager with the specified properties.
javax.persistence.Cache	getCache() Accessor for the second level cache.
javax.persistence.criteria.CriteriaBuilder	getCriteriaBuilder()
Object	getIdentifier(Object entity)
javax.persistence.metamodel.Metamodel	getMetamodel()
org.datanucleus.NucleusContext	getNucleusContext()
javax.persistence.PersistenceUnitUtil	getPersistenceUnitUtil()
Map<String,Object>	getProperties() Get the properties and associated values that are in effect for the entity manager factory.
JPAQueryCache	getQueryCache() Accessor for the query results cache.
org.datanucleus.store.query.cache.QueryDatastoreCompilationCache	getQueryDatastoreCompilationCache() Accessor for the query datastore compilation cache.
org.datanucleus.query.cache.QueryCompilationCache	getQueryGenericCompilationCache() Accessor for the query generic compilation cache.
Set<String>	getSupportedProperties() Get the names of the properties that are supported for use with the entity manager factory.
protected org.datanucleus.NucleusContext	initialiseNucleusContext(org.datanucleus.metadata.PersistenceUnitMetaData unitMetaData, Map overridingProps, org.datanucleus.plugin.PluginManager pluginMgr) Method to initialise a PersistenceManagerFactory that will control the persistence.
boolean	isContainerManaged() Accessor for whether the EMF is managed by a container.
boolean	isLoaded(Object entity)
boolean	isLoaded(Object entity, String attrName)
boolean	isOpen() Accessor for whether the factory is open
protected javax.persistence.EntityManager	newEntityManager(org.datanucleus.NucleusContext nucleusCtx, javax.persistence.PersistenceContextType contextType) Creates an EntityManager.
<T> T	unwrap(Class<T> cls) Return an object of the specified type to allow access to the provider-specific API.

Methods inherited from class java.lang.Object

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

Field Detail

LOCALISER

protected static final org.datanucleus.util.Localiser LOCALISER

Localiser for messages.

LOGGER

public static final org.datanucleus.util.NucleusLogger LOGGER

Logger for enhancing.

Constructor Detail

JPAEntityManagerFactory

public JPAEntityManagerFactory()

Constructor.

JPAEntityManagerFactory

public JPAEntityManagerFactory(javax.persistence.spi.PersistenceUnitInfo unitInfo,
                       Map overridingProps)

Constructor when working in a J2EE environment.

Parameters:

unitInfo - The "persistent-unit" info

overridingProps - factory properties overriding those in the "persistence-unit"

JPAEntityManagerFactory

public JPAEntityManagerFactory(org.datanucleus.metadata.PersistenceUnitMetaData pumd,
                       Map overridingProps)

Convenience constructor to allow for dynamic persistence-unit creation.

Parameters:

pumd - Persistence unit metadata

overridingProps - Properties overriding those defined for this unit

JPAEntityManagerFactory

public JPAEntityManagerFactory(String unitName,
                       Map overridingProps)

Constructor when working in a J2SE environment.

Parameters:

unitName - Name of the "persistent-unit" to use

overridingProps - factory properties overriding those in the "persistence-unit"

Method Detail

getNucleusContext

public org.datanucleus.NucleusContext getNucleusContext()

isContainerManaged

public boolean isContainerManaged()

Accessor for whether the EMF is managed by a container.

Returns:

Whether managed by a container

close

public void close()

Method to close the factory.

Specified by:

close in interface javax.persistence.EntityManagerFactory

isOpen

public boolean isOpen()

Accessor for whether the factory is open

Specified by:

isOpen in interface javax.persistence.EntityManagerFactory

Returns:

Whether it is open

getQueryCache

public JPAQueryCache getQueryCache()

Accessor for the query results cache.

Returns:

Query results cache

getQueryGenericCompilationCache

public org.datanucleus.query.cache.QueryCompilationCache getQueryGenericCompilationCache()

Accessor for the query generic compilation cache.

Returns:

Query generic compilation cache

getQueryDatastoreCompilationCache

public org.datanucleus.store.query.cache.QueryDatastoreCompilationCache getQueryDatastoreCompilationCache()

Accessor for the query datastore compilation cache.

Returns:

Query datastore compilation cache

createEntityManager

public javax.persistence.EntityManager createEntityManager()

Method to create an entity manager.

Specified by:

createEntityManager in interface javax.persistence.EntityManagerFactory

Returns:

The Entity Manager

createEntityManager

public javax.persistence.EntityManager createEntityManager(Map overridingProps)

Method to create an entity manager with the specified properties. This creates a new underlying context since each EMF is locked when created to stop config changes.

Specified by:

createEntityManager in interface javax.persistence.EntityManagerFactory

Parameters:

overridingProps - Properties to use for this manager

Returns:

The Entity Manager

newEntityManager

protected javax.persistence.EntityManager newEntityManager(org.datanucleus.NucleusContext nucleusCtx,
                                               javax.persistence.PersistenceContextType contextType)

Creates an EntityManager. Override if you want to return a different type that implements this interface.

Parameters:

nucleusCtx - Nucleus Context

contextType - The persistence context type

initialiseNucleusContext

protected org.datanucleus.NucleusContext initialiseNucleusContext(org.datanucleus.metadata.PersistenceUnitMetaData unitMetaData,
                                                      Map overridingProps,
                                                      org.datanucleus.plugin.PluginManager pluginMgr)

Method to initialise a PersistenceManagerFactory that will control the persistence. If the unitMetaData is null will simply create a default context without initialising any MetaData etc. If there is a unitMetaData then all metadata for that unit will be loaded/initialised.

Parameters:

unitMetaData - The "persistence-unit" metadata (if any)

overridingProps - Properties to override all others

Returns:

The PersistenceManagerFactory

getProperties

public 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.

Specified by:

getProperties in interface javax.persistence.EntityManagerFactory

Returns:

properties

getSupportedProperties

public Set<String> getSupportedProperties()

Get the names of the properties that are supported for use with the entity manager factory. These correspond to properties that may be passed to the methods of the EntityManagerFactory interface that take a properties argument. These include all standard properties as well as vendor-specific properties supported by the provider. These properties may or may not currently be in effect.

Returns:

properties and hints

assertIsClosed

protected void assertIsClosed()

getCache

public javax.persistence.Cache getCache()

Accessor for the second level cache.

Specified by:

getCache in interface javax.persistence.EntityManagerFactory

Returns:

Level 2 cache

getMetamodel

public javax.persistence.metamodel.Metamodel getMetamodel()

Specified by:

getMetamodel in interface javax.persistence.EntityManagerFactory

getCriteriaBuilder

public javax.persistence.criteria.CriteriaBuilder getCriteriaBuilder()

Specified by:

getCriteriaBuilder in interface javax.persistence.EntityManagerFactory

getPersistenceUnitUtil

public javax.persistence.PersistenceUnitUtil getPersistenceUnitUtil()

Specified by:

getPersistenceUnitUtil in interface javax.persistence.EntityManagerFactory

getIdentifier

public Object getIdentifier(Object entity)

Specified by:

getIdentifier in interface javax.persistence.PersistenceUnitUtil

isLoaded

public boolean isLoaded(Object entity,
               String attrName)

Specified by:

isLoaded in interface javax.persistence.PersistenceUnitUtil

Specified by:

isLoaded in interface javax.persistence.PersistenceUtil

isLoaded

public boolean isLoaded(Object entity)

Specified by:

isLoaded in interface javax.persistence.PersistenceUnitUtil

Specified by:

isLoaded in interface javax.persistence.PersistenceUtil

unwrap

public <T> T unwrap(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:

javax.persistence.PersistenceException - if the provider does not support the call.