org.jboss.as.jpa.container

Class ExtendedEntityManager

java.lang.Object

org.jboss.as.jpa.container.AbstractEntityManager

org.jboss.as.jpa.container.ExtendedEntityManager

All Implemented Interfaces:

Serializable, javax.persistence.EntityManager

public class ExtendedEntityManager
extends AbstractEntityManager
implements Serializable

Represents the Extended persistence context injected into a stateful bean. At bean invocation time, will join the active JTA transaction if one is present. If no active JTA transaction is present, created/deleted/updated/loaded entities will remain associated with the entity manager until it is joined with a transaction (commit will save the changes, rollback will lose them).

At injection time, a instance of this class is associated with the SFSB. During a SFSB1 invocation, if a new SFSB2 is created with an XPC referencing the same persistence unit, the new SFSB2 will inherit the same persistence context from SFSB1. Both SFSB1 + SFSB2 will maintain a reference to the underlying persistence context, such that the underlying persistence context will be kept around until both SFSB1 + SFSB2 are destroyed. At cluster replication time or passivation, both SFSB1 + SFSB2 will be serialized consecutively and this instance will only be serialized once.

Note: Unlike TransactionScopedEntityManager, ExtendedEntityManager will directly be shared instead of the underlying EntityManager.

During serialization, A NotSerializableException will be thrown if the following conditions are not met: - The underlying persistence provider (entity manager) must be Serializable. - The entity classes in the extended persistence context must also be Serializable.

Author:

Scott Marlow

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
ExtendedEntityManager(String puScopedName, javax.persistence.EntityManager underlyingEntityManager)

Method Summary

Methods

Modifier and Type	Method and Description
void	close() Catch the application trying to close the container managed entity manager and throw an IllegalStateException
void	containerClose()
boolean	equals(Object otherObject) Check if this object's UUID is equal to the otherObject's UUID
protected javax.persistence.EntityManager	getEntityManager() The JPA SFSB interceptor will track the stack of SFSB invocations.
String	getScopedPuName() Get the fully application scoped persistence unit name Private api
int	hashCode()
void	internalAssociateWithJtaTx() Associate the extended persistence context with the current JTA transaction (if one is found) this method is private to the JPA subsystem
protected boolean	isExtendedPersistenceContext()
protected boolean	isInTx()
String	toString()

Methods inherited from class org.jboss.as.jpa.container.AbstractEntityManager

clear, contains, createNamedQuery, createNamedQuery, createNativeQuery, createNativeQuery, createNativeQuery, createQuery, createQuery, createQuery, detach, detachNonTxInvocation, detachQueryNonTxInvocation, detachTypedQueryNonTxInvocation, find, find, find, find, flush, getCriteriaBuilder, getDelegate, getEntityManagerFactory, getFlushMode, getLockMode, getMetamodel, getProperties, getReference, getTransaction, isOpen, joinTransaction, lock, lock, merge, persist, refresh, refresh, refresh, refresh, remove, setFlushMode, setProperty, unwrap

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

ExtendedEntityManager

public ExtendedEntityManager(String puScopedName,
                     javax.persistence.EntityManager underlyingEntityManager)

Method Detail

getEntityManager

protected javax.persistence.EntityManager getEntityManager()

The JPA SFSB interceptor will track the stack of SFSB invocations. The underlying EM will be obtained from the current SFSB being invoked (via our JPA SFSB interceptor). Every entity manager call (to AbstractEntityManager) will call this method to get the underlying entity manager (e.g. the Hibernate persistence provider). See org.jboss.ejb3.stateful.EJB3XPCResolver.getExtendedPersistenceContext() to see the as6 implementation of this.

Specified by:

getEntityManager in class AbstractEntityManager

Returns:

EntityManager

internalAssociateWithJtaTx

public void internalAssociateWithJtaTx()

Associate the extended persistence context with the current JTA transaction (if one is found) this method is private to the JPA subsystem

isExtendedPersistenceContext

protected boolean isExtendedPersistenceContext()

Specified by:

isExtendedPersistenceContext in class AbstractEntityManager

Returns:

true if an extended persistence context is in use

Precondition: getEntityManager() must be called previous to calling isExtendedPersistenceContext

isInTx

protected boolean isInTx()

Specified by:

isInTx in class AbstractEntityManager

Returns:

true if a JTA transaction is active

Precondition: getEntityManager() must be called previous to calling isInTx

close

public void close()

Catch the application trying to close the container managed entity manager and throw an IllegalStateException

Specified by:

close in interface javax.persistence.EntityManager

Overrides:

close in class AbstractEntityManager

containerClose

public void containerClose()

toString

public String toString()

Overrides:

toString in class Object

getScopedPuName

public String getScopedPuName()

Get the fully application scoped persistence unit name Private api

Returns:

scoped pu name

equals

public boolean equals(Object otherObject)

Check if this object's UUID is equal to the otherObject's UUID

Overrides:

equals in class Object

Parameters:

otherObject -

Returns:

hashCode

public int hashCode()

Overrides:

hashCode in class Object