org.apache.openejb.persistence

Class JtaEntityManager

java.lang.Object

org.apache.openejb.persistence.JtaEntityManager

All Implemented Interfaces:

Serializable, javax.persistence.EntityManager

public class JtaEntityManager
extends Object
implements javax.persistence.EntityManager, Serializable

The JtaEntityManager is a wrapper around an entity manager that automatically creates and closes entity managers for each transaction in which it is accessed. This implementation supports both transaction and extended scoped JTA entity managers.

It is important that extended scoped entity managers add entity managers to the JtaEntityManagerRegistry when the component is entered and remove them when exited. If this registration is not preformed, an IllegalStateException will be thrown when entity manger is used. It is important that a component adds extended scoped entity managers to the JtaEntityManagerRegistry when the component is entered and removes them when exited. If this registration is not preformed, an IllegalStateException will be thrown when entity manger is accessed.

See Also:

Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	JtaEntityManager.Timer

Constructor Summary

Constructors

Constructor and Description
JtaEntityManager(JtaEntityManagerRegistry registry, javax.persistence.EntityManagerFactory entityManagerFactory, Map properties, String unitName)
JtaEntityManager(String unitName, JtaEntityManagerRegistry registry, javax.persistence.EntityManagerFactory entityManagerFactory, Map properties, boolean extended)

Method Summary

Methods

Modifier and Type	Method and Description
void	clear()
void	close() close throws an IllegalStateException if the em is container managed otherwise (emf.newEM()) it is delegated to the user
boolean	contains(Object entity)
javax.persistence.Query	createNamedQuery(String name)
<T> javax.persistence.TypedQuery<T>	createNamedQuery(String name, Class<T> resultClass)
javax.persistence.Query	createNativeQuery(String sqlString)
javax.persistence.Query	createNativeQuery(String sqlString, Class resultClass)
javax.persistence.Query	createNativeQuery(String sqlString, String resultSetMapping)
<T> javax.persistence.TypedQuery<T>	createQuery(javax.persistence.criteria.CriteriaQuery<T> criteriaQuery)
javax.persistence.Query	createQuery(String qlString)
<T> javax.persistence.TypedQuery<T>	createQuery(String qlString, Class<T> resultClass)
void	detach(Object entity)
<T> T	find(Class<T> entityClass, Object primaryKey)
<T> T	find(Class<T> entityClass, Object primaryKey, javax.persistence.LockModeType lockMode)
<T> T	find(Class<T> entityClass, Object primaryKey, javax.persistence.LockModeType lockMode, Map<String,Object> properties)
<T> T	find(Class<T> entityClass, Object primaryKey, Map<String,Object> properties)
void	flush()
javax.persistence.criteria.CriteriaBuilder	getCriteriaBuilder()
javax.persistence.EntityManager	getDelegate()
javax.persistence.EntityManagerFactory	getEntityManagerFactory()
javax.persistence.FlushModeType	getFlushMode()
javax.persistence.LockModeType	getLockMode(Object entity)
javax.persistence.metamodel.Metamodel	getMetamodel()
Map<String,Object>	getProperties()
<T> T	getReference(Class<T> entityClass, Object primaryKey)
javax.persistence.EntityTransaction	getTransaction()
boolean	isOpen()
void	joinTransaction()
void	lock(Object entity, javax.persistence.LockModeType lockMode)
void	lock(Object entity, javax.persistence.LockModeType lockMode, Map<String,Object> properties)
<T> T	merge(T entity)
void	persist(Object entity)
void	refresh(Object entity)
void	refresh(Object entity, javax.persistence.LockModeType lockMode)
void	refresh(Object entity, javax.persistence.LockModeType lockMode, Map<String,Object> properties)
void	refresh(Object entity, Map<String,Object> properties)
void	remove(Object entity)
void	setFlushMode(javax.persistence.FlushModeType flushMode)
void	setProperty(String name, Object value)
<T> T	unwrap(Class<T> cls)
protected Object	writeReplace()

Methods inherited from class java.lang.Object

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

Constructor Detail

JtaEntityManager

public JtaEntityManager(JtaEntityManagerRegistry registry,
                javax.persistence.EntityManagerFactory entityManagerFactory,
                Map properties,
                String unitName)

JtaEntityManager

public JtaEntityManager(String unitName,
                JtaEntityManagerRegistry registry,
                javax.persistence.EntityManagerFactory entityManagerFactory,
                Map properties,
                boolean extended)

Method Detail

getDelegate

public javax.persistence.EntityManager getDelegate()

Specified by:

getDelegate in interface javax.persistence.EntityManager

persist

public void persist(Object entity)

Specified by:

persist in interface javax.persistence.EntityManager

merge

public <T> T merge(T entity)

Specified by:

merge in interface javax.persistence.EntityManager

remove

public void remove(Object entity)

Specified by:

remove in interface javax.persistence.EntityManager

find

public <T> T find(Class<T> entityClass,
         Object primaryKey)

Specified by:

find in interface javax.persistence.EntityManager

getReference

public <T> T getReference(Class<T> entityClass,
                 Object primaryKey)

Specified by:

getReference in interface javax.persistence.EntityManager

flush

public void flush()

Specified by:

flush in interface javax.persistence.EntityManager

setFlushMode

public void setFlushMode(javax.persistence.FlushModeType flushMode)

Specified by:

setFlushMode in interface javax.persistence.EntityManager

getFlushMode

public javax.persistence.FlushModeType getFlushMode()

Specified by:

getFlushMode in interface javax.persistence.EntityManager

lock

public void lock(Object entity,
        javax.persistence.LockModeType lockMode)

Specified by:

lock in interface javax.persistence.EntityManager

refresh

public void refresh(Object entity)

Specified by:

refresh in interface javax.persistence.EntityManager

clear

public void clear()

Specified by:

clear in interface javax.persistence.EntityManager

contains

public boolean contains(Object entity)

Specified by:

contains in interface javax.persistence.EntityManager

createQuery

public javax.persistence.Query createQuery(String qlString)

Specified by:

createQuery in interface javax.persistence.EntityManager

createNamedQuery

public javax.persistence.Query createNamedQuery(String name)

Specified by:

createNamedQuery in interface javax.persistence.EntityManager

createNativeQuery

public javax.persistence.Query createNativeQuery(String sqlString)

Specified by:

createNativeQuery in interface javax.persistence.EntityManager

createNativeQuery

public javax.persistence.Query createNativeQuery(String sqlString,
                                        Class resultClass)

Specified by:

createNativeQuery in interface javax.persistence.EntityManager

createNativeQuery

public javax.persistence.Query createNativeQuery(String sqlString,
                                        String resultSetMapping)

Specified by:

createNativeQuery in interface javax.persistence.EntityManager

joinTransaction

public void joinTransaction()

Specified by:

joinTransaction in interface javax.persistence.EntityManager

close

public void close()

close throws an IllegalStateException if the em is container managed otherwise (emf.newEM()) it is delegated to the user

Specified by:

close in interface javax.persistence.EntityManager

isOpen

public boolean isOpen()

Specified by:

isOpen in interface javax.persistence.EntityManager

getTransaction

public javax.persistence.EntityTransaction getTransaction()

Specified by:

getTransaction in interface javax.persistence.EntityManager

createNamedQuery

public <T> javax.persistence.TypedQuery<T> createNamedQuery(String name,
                                                   Class<T> resultClass)

Specified by:

createNamedQuery in interface javax.persistence.EntityManager

createQuery

public <T> javax.persistence.TypedQuery<T> createQuery(javax.persistence.criteria.CriteriaQuery<T> criteriaQuery)

Specified by:

createQuery in interface javax.persistence.EntityManager

createQuery

public <T> javax.persistence.TypedQuery<T> createQuery(String qlString,
                                              Class<T> resultClass)

Specified by:

createQuery in interface javax.persistence.EntityManager

detach

public void detach(Object entity)

Specified by:

detach in interface javax.persistence.EntityManager

find

public <T> T find(Class<T> entityClass,
         Object primaryKey,
         Map<String,Object> properties)

Specified by:

find in interface javax.persistence.EntityManager

find

public <T> T find(Class<T> entityClass,
         Object primaryKey,
         javax.persistence.LockModeType lockMode)

Specified by:

find in interface javax.persistence.EntityManager

find

public <T> T find(Class<T> entityClass,
         Object primaryKey,
         javax.persistence.LockModeType lockMode,
         Map<String,Object> properties)

Specified by:

find in interface javax.persistence.EntityManager

getEntityManagerFactory

public javax.persistence.EntityManagerFactory getEntityManagerFactory()

Specified by:

getEntityManagerFactory in interface javax.persistence.EntityManager

getLockMode

public javax.persistence.LockModeType getLockMode(Object entity)

Specified by:

getLockMode in interface javax.persistence.EntityManager

getMetamodel

public javax.persistence.metamodel.Metamodel getMetamodel()

Specified by:

getMetamodel in interface javax.persistence.EntityManager

getProperties

public Map<String,Object> getProperties()

Specified by:

getProperties in interface javax.persistence.EntityManager

getCriteriaBuilder

public javax.persistence.criteria.CriteriaBuilder getCriteriaBuilder()

Specified by:

getCriteriaBuilder in interface javax.persistence.EntityManager

lock

public void lock(Object entity,
        javax.persistence.LockModeType lockMode,
        Map<String,Object> properties)

Specified by:

lock in interface javax.persistence.EntityManager

refresh

public void refresh(Object entity,
           Map<String,Object> properties)

Specified by:

refresh in interface javax.persistence.EntityManager

refresh

public void refresh(Object entity,
           javax.persistence.LockModeType lockMode)

Specified by:

refresh in interface javax.persistence.EntityManager

refresh

public void refresh(Object entity,
           javax.persistence.LockModeType lockMode,
           Map<String,Object> properties)

Specified by:

refresh in interface javax.persistence.EntityManager

setProperty

public void setProperty(String name,
               Object value)

Specified by:

setProperty in interface javax.persistence.EntityManager

unwrap

public <T> T unwrap(Class<T> cls)

Specified by:

unwrap in interface javax.persistence.EntityManager

writeReplace

protected Object writeReplace()
                       throws ObjectStreamException

Throws:

ObjectStreamException