org.hibernate.ejb
Class AbstractEntityManagerImpl

java.lang.Object
  extended by org.hibernate.ejb.AbstractEntityManagerImpl
All Implemented Interfaces:
Serializable, EntityManager, HibernateEntityManager, HibernateEntityManagerImplementor
Direct Known Subclasses:
CurrentEntityManagerImpl, EntityManagerImpl

public abstract class AbstractEntityManagerImpl
extends Object
implements HibernateEntityManagerImplementor, Serializable

Author:
Gavin King, Emmanuel Bernard, Steve Ebersole, Hardy Ferentschik
See Also:
Serialized Form

Nested Class Summary
 
Nested classes/interfaces inherited from interface org.hibernate.ejb.HibernateEntityManagerImplementor
HibernateEntityManagerImplementor.Options
 
Field Summary
protected  PersistenceContextType persistenceContextType
           
protected  TransactionImpl tx
           
 
Constructor Summary
protected AbstractEntityManagerImpl(EntityManagerFactoryImpl entityManagerFactory, PersistenceContextType type, PersistenceUnitTransactionType transactionType, Map properties)
           
 
Method Summary
 void clear()
           
 boolean contains(Object entity)
           
 RuntimeException convert(HibernateException e)
          Converts a Hibernate-specific exception into a JPA-specified exception; note that the JPA sepcification makes use of exceptions outside its exception hierarchy, though they are all runtime exceptions.
 RuntimeException convert(HibernateException e, LockOptions lockOptions)
          Converts a Hibernate-specific exception into a JPA-specified exception; note that the JPA sepcification makes use of exceptions outside its exception hierarchy, though they are all runtime exceptions.
 RuntimeException convert(RuntimeException e)
           
 Query createNamedQuery(String name)
           
<T> TypedQuery<T>
createNamedQuery(String name, Class<T> resultClass)
           
 Query createNativeQuery(String sqlString)
           
 Query createNativeQuery(String sqlString, Class resultClass)
           
 Query createNativeQuery(String sqlString, String resultSetMapping)
           
<T> TypedQuery<T>
createQuery(javax.persistence.criteria.CriteriaQuery<T> criteriaQuery)
           
 Query createQuery(String jpaqlString)
           
<T> TypedQuery<T>
createQuery(String jpaqlString, Class<T> resultClass)
           
<T> TypedQuery<T>
createQuery(String jpaqlString, Class<T> resultClass, javax.persistence.criteria.Selection selection, HibernateEntityManagerImplementor.Options options)
          Used during "compiling" a JPA criteria query.
 void detach(Object entity)
           
 CacheMode determineAppropriateLocalCacheMode(Map<String,Object> localProperties)
           
<A> A
find(Class<A> entityClass, Object primaryKey)
           
<A> A
find(Class<A> entityClass, Object primaryKey, LockModeType lockModeType)
           
<A> A
find(Class<A> entityClass, Object primaryKey, LockModeType lockModeType, Map<String,Object> properties)
           
<T> T
find(Class<T> entityClass, Object primaryKey, Map<String,Object> properties)
           
 void flush()
           
 javax.persistence.criteria.CriteriaBuilder getCriteriaBuilder()
          
 Object getDelegate()
          returns the underlying session
 EntityManagerFactoryImpl getEntityManagerFactory()
          
 HibernateEntityManagerFactory getFactory()
          Get access to the Hibernate extended EMF contract.
 FlushModeType getFlushMode()
          Hibernate can be set in various flush modes that are unknown to JPA 2.0.
 LockModeType getLockMode(Object entity)
           
 LockOptions getLockRequest(LockModeType lockModeType, Map<String,Object> properties)
          Convert from JPA 2 LockModeType & properties into LockOptions
 javax.persistence.metamodel.Metamodel getMetamodel()
          
 Map<String,Object> getProperties()
           
protected abstract  Session getRawSession()
          Return a Session (even if the entity manager is closed).
<T> T
getReference(Class<T> entityClass, Object primaryKey)
           
abstract  Session getSession()
          return a Session
 EntityTransaction getTransaction()
           
 void handlePersistenceException(PersistenceException e)
          Handles marking for rollback and other such operations that need to occur depending on the type of exception being handled.
 boolean isTransactionInProgress()
          Provides access to whether a transaction is currently in progress.
 void joinTransaction()
           
 void lock(Object entity, LockModeType lockMode)
           
 void lock(Object entity, LockModeType lockModeType, Map<String,Object> properties)
           
protected  void markAsRollback()
           
<A> A
merge(A entity)
           
 void persist(Object entity)
           
protected  void postInit()
           
 void refresh(Object entity)
           
 void refresh(Object entity, LockModeType lockModeType)
           
 void refresh(Object entity, LockModeType lockModeType, Map<String,Object> properties)
           
 void refresh(Object entity, Map<String,Object> properties)
           
 void remove(Object entity)
           
 void setFlushMode(FlushModeType flushModeType)
           
 void setProperty(String s, Object o)
           
 void throwPersistenceException(HibernateException e)
          Delegates to HibernateEntityManagerImplementor.convert(org.hibernate.HibernateException, org.hibernate.LockOptions) and then throws the given exception.
 void throwPersistenceException(PersistenceException e)
          Delegates to HibernateEntityManagerImplementor.handlePersistenceException(javax.persistence.PersistenceException) and then throws the given exception.
<T> T
unwrap(Class<T> clazz)
           
 PersistenceException wrapLockException(HibernateException e, LockOptions lockOptions)
           
 PersistenceException wrapStaleStateException(StaleStateException e)
          
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 
Methods inherited from interface javax.persistence.EntityManager
close, isOpen
 

Field Detail

tx

protected transient TransactionImpl tx

persistenceContextType

protected PersistenceContextType persistenceContextType
Constructor Detail

AbstractEntityManagerImpl

protected AbstractEntityManagerImpl(EntityManagerFactoryImpl entityManagerFactory,
                                    PersistenceContextType type,
                                    PersistenceUnitTransactionType transactionType,
                                    Map properties)
Method Detail

postInit

protected void postInit()

createQuery

public Query createQuery(String jpaqlString)
Specified by:
createQuery in interface EntityManager

createQuery

public <T> TypedQuery<T> createQuery(String jpaqlString,
                                     Class<T> resultClass)
Specified by:
createQuery in interface EntityManager

createQuery

public <T> TypedQuery<T> createQuery(String jpaqlString,
                                     Class<T> resultClass,
                                     javax.persistence.criteria.Selection selection,
                                     HibernateEntityManagerImplementor.Options options)
Description copied from interface: HibernateEntityManagerImplementor
Used during "compiling" a JPA criteria query.

Specified by:
createQuery in interface HibernateEntityManagerImplementor
Type Parameters:
T - The query type
Parameters:
jpaqlString - The criteria query rendered as a JPA QL string
resultClass - The result type (the type expected in the result list)
selection - The selection(s)
options - The options to use to build the query.
Returns:
The typed query

createQuery

public <T> TypedQuery<T> createQuery(javax.persistence.criteria.CriteriaQuery<T> criteriaQuery)
Specified by:
createQuery in interface EntityManager

createNamedQuery

public Query createNamedQuery(String name)
Specified by:
createNamedQuery in interface EntityManager

createNamedQuery

public <T> TypedQuery<T> createNamedQuery(String name,
                                          Class<T> resultClass)
Specified by:
createNamedQuery in interface EntityManager

createNativeQuery

public Query createNativeQuery(String sqlString)
Specified by:
createNativeQuery in interface EntityManager

createNativeQuery

public Query createNativeQuery(String sqlString,
                               Class resultClass)
Specified by:
createNativeQuery in interface EntityManager

createNativeQuery

public Query createNativeQuery(String sqlString,
                               String resultSetMapping)
Specified by:
createNativeQuery in interface EntityManager

getReference

public <T> T getReference(Class<T> entityClass,
                          Object primaryKey)
Specified by:
getReference in interface EntityManager

find

public <A> A find(Class<A> entityClass,
                  Object primaryKey)
Specified by:
find in interface EntityManager

find

public <T> T find(Class<T> entityClass,
                  Object primaryKey,
                  Map<String,Object> properties)
Specified by:
find in interface EntityManager

find

public <A> A find(Class<A> entityClass,
                  Object primaryKey,
                  LockModeType lockModeType)
Specified by:
find in interface EntityManager

find

public <A> A find(Class<A> entityClass,
                  Object primaryKey,
                  LockModeType lockModeType,
                  Map<String,Object> properties)
Specified by:
find in interface EntityManager

determineAppropriateLocalCacheMode

public CacheMode determineAppropriateLocalCacheMode(Map<String,Object> localProperties)

persist

public void persist(Object entity)
Specified by:
persist in interface EntityManager

merge

public <A> A merge(A entity)
Specified by:
merge in interface EntityManager

remove

public void remove(Object entity)
Specified by:
remove in interface EntityManager

refresh

public void refresh(Object entity)
Specified by:
refresh in interface EntityManager

refresh

public void refresh(Object entity,
                    Map<String,Object> properties)
Specified by:
refresh in interface EntityManager

refresh

public void refresh(Object entity,
                    LockModeType lockModeType)
Specified by:
refresh in interface EntityManager

refresh

public void refresh(Object entity,
                    LockModeType lockModeType,
                    Map<String,Object> properties)
Specified by:
refresh in interface EntityManager

contains

public boolean contains(Object entity)
Specified by:
contains in interface EntityManager

getLockMode

public LockModeType getLockMode(Object entity)
Specified by:
getLockMode in interface EntityManager

setProperty

public void setProperty(String s,
                        Object o)
Specified by:
setProperty in interface EntityManager

getProperties

public Map<String,Object> getProperties()
Specified by:
getProperties in interface EntityManager

flush

public void flush()
Specified by:
flush in interface EntityManager

getSession

public abstract Session getSession()
return a Session

Specified by:
getSession in interface HibernateEntityManager
Returns:
Throws:
IllegalStateException - if the entity manager is closed

getRawSession

protected abstract Session getRawSession()
Return a Session (even if the entity manager is closed).

Returns:
A session.

getTransaction

public EntityTransaction getTransaction()
Specified by:
getTransaction in interface EntityManager

getEntityManagerFactory

public EntityManagerFactoryImpl getEntityManagerFactory()

Specified by:
getEntityManagerFactory in interface EntityManager

getFactory

public HibernateEntityManagerFactory getFactory()
Get access to the Hibernate extended EMF contract.

Specified by:
getFactory in interface HibernateEntityManagerImplementor
Returns:
The Hibernate EMF contract for this EM.

getCriteriaBuilder

public javax.persistence.criteria.CriteriaBuilder getCriteriaBuilder()

Specified by:
getCriteriaBuilder in interface EntityManager

getMetamodel

public javax.persistence.metamodel.Metamodel getMetamodel()

Specified by:
getMetamodel in interface EntityManager

setFlushMode

public void setFlushMode(FlushModeType flushModeType)
Specified by:
setFlushMode in interface EntityManager

clear

public void clear()
Specified by:
clear in interface EntityManager

detach

public void detach(Object entity)
Specified by:
detach in interface EntityManager

getFlushMode

public FlushModeType getFlushMode()
Hibernate can be set in various flush modes that are unknown to JPA 2.0. This method can then return null. If it returns null, do em.unwrap(Session.class).getFlushMode() to get the Hibernate flush mode

Specified by:
getFlushMode in interface EntityManager

lock

public void lock(Object entity,
                 LockModeType lockMode)
Specified by:
lock in interface EntityManager

lock

public void lock(Object entity,
                 LockModeType lockModeType,
                 Map<String,Object> properties)
Specified by:
lock in interface EntityManager

getLockRequest

public LockOptions getLockRequest(LockModeType lockModeType,
                                  Map<String,Object> properties)
Description copied from interface: HibernateEntityManagerImplementor
Convert from JPA 2 LockModeType & properties into LockOptions

Specified by:
getLockRequest in interface HibernateEntityManagerImplementor
Parameters:
lockModeType - is the requested lock type
properties - are the lock properties
Returns:
the LockOptions

isTransactionInProgress

public boolean isTransactionInProgress()
Description copied from interface: HibernateEntityManagerImplementor
Provides access to whether a transaction is currently in progress.

Specified by:
isTransactionInProgress in interface HibernateEntityManagerImplementor
Returns:
True if a transaction is considered currently in progress; false otherwise.

markAsRollback

protected void markAsRollback()

joinTransaction

public void joinTransaction()
Specified by:
joinTransaction in interface EntityManager

unwrap

public <T> T unwrap(Class<T> clazz)
Specified by:
unwrap in interface EntityManager

getDelegate

public Object getDelegate()
returns the underlying session

Specified by:
getDelegate in interface EntityManager

handlePersistenceException

public void handlePersistenceException(PersistenceException e)
Handles marking for rollback and other such operations that need to occur depending on the type of exception being handled.

Specified by:
handlePersistenceException in interface HibernateEntityManagerImplementor
Parameters:
e - The exception being handled.

throwPersistenceException

public void throwPersistenceException(PersistenceException e)
Delegates to HibernateEntityManagerImplementor.handlePersistenceException(javax.persistence.PersistenceException) and then throws the given exception.

Specified by:
throwPersistenceException in interface HibernateEntityManagerImplementor
Parameters:
e - The exception being handled and finally thrown.

convert

public RuntimeException convert(HibernateException e)
Converts a Hibernate-specific exception into a JPA-specified exception; note that the JPA sepcification makes use of exceptions outside its exception hierarchy, though they are all runtime exceptions.

Any appropriate/needed calls to HibernateEntityManagerImplementor.handlePersistenceException(javax.persistence.PersistenceException) are also made.

Specified by:
convert in interface HibernateEntityManagerImplementor
Parameters:
e - The Hibernate excepton.
Returns:
The JPA-specified exception

convert

public RuntimeException convert(RuntimeException e)

convert

public RuntimeException convert(HibernateException e,
                                LockOptions lockOptions)
Converts a Hibernate-specific exception into a JPA-specified exception; note that the JPA sepcification makes use of exceptions outside its exception hierarchy, though they are all runtime exceptions.

Any appropriate/needed calls to HibernateEntityManagerImplementor.handlePersistenceException(javax.persistence.PersistenceException) are also made.

Specified by:
convert in interface HibernateEntityManagerImplementor
Parameters:
e - The Hibernate excepton.
lockOptions - The lock options in effect at the time of exception (can be null)
Returns:
The JPA-specified exception

throwPersistenceException

public void throwPersistenceException(HibernateException e)
Delegates to HibernateEntityManagerImplementor.convert(org.hibernate.HibernateException, org.hibernate.LockOptions) and then throws the given exception.

Specified by:
throwPersistenceException in interface HibernateEntityManagerImplementor
Parameters:
e - The exception being handled and finally thrown.

wrapStaleStateException

public PersistenceException wrapStaleStateException(StaleStateException e)

Specified by:
wrapStaleStateException in interface HibernateEntityManagerImplementor

wrapLockException

public PersistenceException wrapLockException(HibernateException e,
                                              LockOptions lockOptions)


Copyright © 2001-2010 Red Hat, Inc. All Rights Reserved.