JtaEntityManager

java.lang.Object
- org.apache.openejb.persistence.JtaEntityManager

All Implemented Interfaces:

java.io.Serializable
```
public class JtaEntityManager
extends java.lang.Object
implements java.io.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

Nested Classes
Modifier and Type	Class and Description
`static class`	`JtaEntityManager.Timer`

Constructor Summary

Constructors
Constructor and Description
`JtaEntityManager(JtaEntityManagerRegistry registry, EntityManagerFactory entityManagerFactory, java.util.Map properties, java.lang.String unitName, java.lang.String synchronizationType)`
`JtaEntityManager(java.lang.String unitName, JtaEntityManagerRegistry registry, EntityManagerFactory entityManagerFactory, java.util.Map properties, boolean extended, java.lang.String synchronizationType)`

Method Summary

All Methods Static Methods Instance Methods Concrete 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(java.lang.Object entity)`
`<T> <any>`	`createEntityGraph(java.lang.Class<T> rootType)`
`<any>`	`createEntityGraph(java.lang.String graphName)`
`Query`	`createNamedQuery(java.lang.String name)`
`<T> <any>`	`createNamedQuery(java.lang.String name, java.lang.Class<T> resultClass)`
`StoredProcedureQuery`	`createNamedStoredProcedureQuery(java.lang.String name)`
`Query`	`createNativeQuery(java.lang.String sqlString)`
`Query`	`createNativeQuery(java.lang.String sqlString, java.lang.Class resultClass)`
`Query`	`createNativeQuery(java.lang.String sqlString, java.lang.String resultSetMapping)`
`<T> <any>`	`createQuery(<any> criteriaQuery)`
`Query`	`createQuery(CriteriaDelete deleteQuery)`
`Query`	`createQuery(CriteriaUpdate updateQuery)`
`Query`	`createQuery(java.lang.String qlString)`
`<T> <any>`	`createQuery(java.lang.String qlString, java.lang.Class<T> resultClass)`
`StoredProcedureQuery`	`createStoredProcedureQuery(java.lang.String procedureName)`
`StoredProcedureQuery`	`createStoredProcedureQuery(java.lang.String procedureName, java.lang.Class... resultClasses)`
`StoredProcedureQuery`	`createStoredProcedureQuery(java.lang.String procedureName, java.lang.String... resultSetMappings)`
`void`	`detach(java.lang.Object entity)`
`<T> T`	`find(java.lang.Class<T> entityClass, java.lang.Object primaryKey)`
`<T> T`	`find(java.lang.Class<T> entityClass, java.lang.Object primaryKey, LockModeType lockMode)`
`<T> T`	`find(java.lang.Class<T> entityClass, java.lang.Object primaryKey, LockModeType lockMode, java.util.Map<java.lang.String,java.lang.Object> properties)`
`<T> T`	`find(java.lang.Class<T> entityClass, java.lang.Object primaryKey, java.util.Map<java.lang.String,java.lang.Object> properties)`
`void`	`flush()`
`CriteriaBuilder`	`getCriteriaBuilder()`
`EntityManager`	`getDelegate()`
`<any>`	`getEntityGraph(java.lang.String graphName)`
`<T> java.util.List<<any>>`	`getEntityGraphs(java.lang.Class<T> entityClass)`
`EntityManagerFactory`	`getEntityManagerFactory()`
`FlushModeType`	`getFlushMode()`
`LockModeType`	`getLockMode(java.lang.Object entity)`
`Metamodel`	`getMetamodel()`
`java.util.Map<java.lang.String,java.lang.Object>`	`getProperties()`
`<T> T`	`getReference(java.lang.Class<T> entityClass, java.lang.Object primaryKey)`
`EntityTransaction`	`getTransaction()`
`boolean`	`isJoinedToTransaction()`
`static boolean`	`isJPA21(EntityManagerFactory entityManagerFactory)`
`boolean`	`isOpen()`
`void`	`joinTransaction()`
`void`	`lock(java.lang.Object entity, LockModeType lockMode)`
`void`	`lock(java.lang.Object entity, LockModeType lockMode, java.util.Map<java.lang.String,java.lang.Object> properties)`
`<T> T`	`merge(T entity)`
`void`	`persist(java.lang.Object entity)`
`void`	`refresh(java.lang.Object entity)`
`void`	`refresh(java.lang.Object entity, LockModeType lockMode)`
`void`	`refresh(java.lang.Object entity, LockModeType lockMode, java.util.Map<java.lang.String,java.lang.Object> properties)`
`void`	`refresh(java.lang.Object entity, java.util.Map<java.lang.String,java.lang.Object> properties)`
`void`	`remove(java.lang.Object entity)`
`void`	`setFlushMode(FlushModeType flushMode)`
`void`	`setProperty(java.lang.String name, java.lang.Object value)`
`<T> T`	`unwrap(java.lang.Class<T> cls)`
`protected java.lang.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,
                        EntityManagerFactory entityManagerFactory,
                        java.util.Map properties,
                        java.lang.String unitName,
                        java.lang.String synchronizationType)

JtaEntityManager

public JtaEntityManager(java.lang.String unitName,
                        JtaEntityManagerRegistry registry,
                        EntityManagerFactory entityManagerFactory,
                        java.util.Map properties,
                        boolean extended,
                        java.lang.String synchronizationType)

Method Detail

isJPA21

public static boolean isJPA21(EntityManagerFactory entityManagerFactory)

getDelegate
```
public EntityManager getDelegate()
```

persist

public void persist(java.lang.Object entity)

merge
```
public <T> T merge(T entity)
```

remove

public void remove(java.lang.Object entity)

find

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

getReference

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

flush
```
public void flush()
```

setFlushMode

public void setFlushMode(FlushModeType flushMode)

getFlushMode
```
public FlushModeType getFlushMode()
```

lock

public void lock(java.lang.Object entity,
                 LockModeType lockMode)

refresh

public void refresh(java.lang.Object entity)

clear
```
public void clear()
```

contains

public boolean contains(java.lang.Object entity)

createQuery

public Query createQuery(java.lang.String qlString)

createNamedQuery

public Query createNamedQuery(java.lang.String name)

createNativeQuery

public Query createNativeQuery(java.lang.String sqlString)

createNativeQuery

public Query createNativeQuery(java.lang.String sqlString,
                               java.lang.Class resultClass)

createNativeQuery

public Query createNativeQuery(java.lang.String sqlString,
                               java.lang.String resultSetMapping)

joinTransaction
```
public void joinTransaction()
```

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

isOpen
```
public boolean isOpen()
```

getTransaction

public EntityTransaction getTransaction()

createNamedQuery

public <T> <any> createNamedQuery(java.lang.String name,
                                  java.lang.Class<T> resultClass)

createQuery

public <T> <any> createQuery(<any> criteriaQuery)

createQuery

public <T> <any> createQuery(java.lang.String qlString,
                             java.lang.Class<T> resultClass)

detach

public void detach(java.lang.Object entity)

find

public <T> T find(java.lang.Class<T> entityClass,
                  java.lang.Object primaryKey,
                  java.util.Map<java.lang.String,java.lang.Object> properties)

find

public <T> T find(java.lang.Class<T> entityClass,
                  java.lang.Object primaryKey,
                  LockModeType lockMode)

find

public <T> T find(java.lang.Class<T> entityClass,
                  java.lang.Object primaryKey,
                  LockModeType lockMode,
                  java.util.Map<java.lang.String,java.lang.Object> properties)

getEntityManagerFactory

public EntityManagerFactory getEntityManagerFactory()

getLockMode

public LockModeType getLockMode(java.lang.Object entity)

getMetamodel
```
public Metamodel getMetamodel()
```

getProperties

public java.util.Map<java.lang.String,java.lang.Object> getProperties()

getCriteriaBuilder

public CriteriaBuilder getCriteriaBuilder()

lock

public void lock(java.lang.Object entity,
                 LockModeType lockMode,
                 java.util.Map<java.lang.String,java.lang.Object> properties)

refresh

public void refresh(java.lang.Object entity,
                    java.util.Map<java.lang.String,java.lang.Object> properties)

refresh

public void refresh(java.lang.Object entity,
                    LockModeType lockMode)

refresh

public void refresh(java.lang.Object entity,
                    LockModeType lockMode,
                    java.util.Map<java.lang.String,java.lang.Object> properties)

setProperty

public void setProperty(java.lang.String name,
                        java.lang.Object value)

unwrap

public <T> T unwrap(java.lang.Class<T> cls)

writeReplace

protected java.lang.Object writeReplace()
                                 throws java.io.ObjectStreamException

Throws:: java.io.ObjectStreamException

createNamedStoredProcedureQuery

public StoredProcedureQuery createNamedStoredProcedureQuery(java.lang.String name)

createStoredProcedureQuery

public StoredProcedureQuery createStoredProcedureQuery(java.lang.String procedureName)

createStoredProcedureQuery

public StoredProcedureQuery createStoredProcedureQuery(java.lang.String procedureName,
                                                       java.lang.Class... resultClasses)

createStoredProcedureQuery

public StoredProcedureQuery createStoredProcedureQuery(java.lang.String procedureName,
                                                       java.lang.String... resultSetMappings)

createQuery

public Query createQuery(CriteriaUpdate updateQuery)

createQuery

public Query createQuery(CriteriaDelete deleteQuery)

createEntityGraph

public <T> <any> createEntityGraph(java.lang.Class<T> rootType)

createEntityGraph

public <any> createEntityGraph(java.lang.String graphName)

getEntityGraph

public <any> getEntityGraph(java.lang.String graphName)

getEntityGraphs

public <T> java.util.List<<any>> getEntityGraphs(java.lang.Class<T> entityClass)

isJoinedToTransaction

public boolean isJoinedToTransaction()

Class JtaEntityManager

Nested Class Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

JtaEntityManager

JtaEntityManager

Method Detail

isJPA21

getDelegate

persist

merge

remove

find

getReference

flush

setFlushMode

getFlushMode

lock

refresh

clear

contains

createQuery

createNamedQuery

createNativeQuery

createNativeQuery

createNativeQuery

joinTransaction

close

isOpen

getTransaction

createNamedQuery

createQuery

createQuery

detach

find

find

find

getEntityManagerFactory

getLockMode

getMetamodel

getProperties

getCriteriaBuilder

lock

refresh

refresh

refresh

setProperty

unwrap

writeReplace

createNamedStoredProcedureQuery

createStoredProcedureQuery

createStoredProcedureQuery

createStoredProcedureQuery

createQuery

createQuery

createEntityGraph

createEntityGraph

getEntityGraph

getEntityGraphs

isJoinedToTransaction