org.jboss.ejb3.stateful
Class StatefulBeanContext

java.lang.Object
  org.jboss.ejb3.BaseContext<T>
      org.jboss.ejb3.session.SessionBeanContext<T>
          org.jboss.ejb3.session.SessionSpecBeanContext<StatefulContainer>
              org.jboss.ejb3.stateful.StatefulBeanContext

All Implemented Interfaces:

java.io.Externalizable, java.io.Serializable, org.jboss.ejb3.cache.Identifiable, org.jboss.ejb3.interceptors.container.BeanContext<java.lang.Object>, org.jboss.ejb3.tx.container.StatefulBeanContext<java.lang.Object>

Direct Known Subclasses:

NestedStatefulBeanContext, ProxiedStatefulBeanContext

public class StatefulBeanContext
extends SessionSpecBeanContext<StatefulContainer>
implements org.jboss.ejb3.cache.Identifiable, java.io.Externalizable, org.jboss.ejb3.tx.container.StatefulBeanContext<java.lang.Object>

BeanContext for a stateful session bean. Either bean or beanMO are always filled.

See Also:

Serialized Form

Field Summary

protected org.jboss.serial.io.MarshalledObject	beanMO
protected StatefulBeanContext	containedIn
protected java.lang.String	containerClusterUid
protected java.lang.String	containerGuid
protected java.util.List<StatefulBeanContext>	contains
static ThreadLocalStack<StatefulBeanContext>	currentBean
protected boolean	discarded
protected java.lang.Object	id
protected boolean	inInvocation
protected boolean	isClustered
long	lastUsed
protected java.util.concurrent.locks.ReentrantLock	lock
boolean	markedForPassivation
boolean	markedForReplication
protected boolean	passivated
protected java.util.HashMap<java.lang.String,javax.persistence.EntityManager>	persistenceContexts
static ThreadLocalStack<StatefulBeanContext>	propagatedContainedIn
protected boolean	removed
protected boolean	replicationIsPassivation
protected boolean	txSynchronized

Fields inherited from class org.jboss.ejb3.session.SessionBeanContext

ejbContext

Fields inherited from class org.jboss.ejb3.BaseContext

bean, container, interceptorInstances, log, metadata, rm

Constructor Summary

	StatefulBeanContext() Deprecated.
protected	StatefulBeanContext(StatefulContainer container, org.jboss.serial.io.MarshalledObject beanMO) An incoming context from serialization.
protected	StatefulBeanContext(StatefulContainer container, java.lang.Object bean) A brand new stateful session bean.

Method Summary

void	activateAfterReplication()
void	addContains(StatefulBeanContext ctx)
void	addExtendedPersistenceContext(java.lang.String id, javax.persistence.EntityManager pc)
protected void	discard()
boolean	equals(java.lang.Object obj)
protected void	extractBeanAndInterceptors()
boolean	getCanPassivate() Checks whether this context or any of its children are in use.
boolean	getCanRemoveFromCache()
StatefulBeanContext	getContainedIn()
StatefulContainer	getContainer()
java.util.List<StatefulBeanContext>	getContains()
org.jboss.ejb3.context.spi.EJBContext	getEJBContext()
javax.persistence.EntityManager	getExtendedPersistenceContext(java.lang.String id)
java.util.Map<java.lang.String,javax.persistence.EntityManager>	getExtendedPersistenceContexts()
java.lang.Object	getId()
java.lang.Object	getInstance() Returns the enterprise bean, never returns null.
java.lang.Object[]	getInterceptorInstances(InterceptorInfo[] interceptorInfos)
java.lang.Object	getInvokedMethodKey()
java.util.concurrent.locks.ReentrantLock	getLock()
org.jboss.aop.metadata.SimpleMetaData	getMetaData()
boolean	getReplicationIsPassivation()
protected javax.ejb.SessionSynchronization	getSessionSynchronization()
StatefulBeanContext	getUltimateContainedIn()
int	hashCode()
boolean	isDiscarded()
boolean	isInInvocation()
boolean	isInUse()
boolean	isModified()
boolean	isRemoved()
boolean	isTxSynchronized()
void	passivateAfterReplication() Notification from a ClusteredStatefulCache to inform that a bean that is stored in the distributed cache is now being passivated as well.
void	popContainedIn()
void	postActivate() Notification from a non-clustered StatefulCache to inform that we have been activated.
void	postReplicate() Notification from a ClusteredStatefulCache after the bean is fetched from the distributed cache.
void	prePassivate() Notification from a non-clustered StatefulCache to inform that we are about to be passivated.
void	preReplicate() Notification from a ClusteredStatefulCache before a bean is replicated.
StatefulBeanContext	pushContainedIn()
void	readExternal(java.io.ObjectInput in)
protected void	registerSynchronization(javax.transaction.Transaction tx, javax.transaction.Synchronization sync) To make sure Synchronizations are executed in a given order we maintain a sync registry within this object.
void	remove()
void	removeContains(StatefulBeanContext ctx)
void	removeExtendedPersistenceContext(java.lang.String id)
boolean	scanForExtendedPersistenceContext(java.lang.String id, StatefulBeanContext ignore)
void	setDiscarded(boolean discarded)
void	setInInvocation(boolean inInvocation)
void	setInUse(boolean inUse)
void	setReplicationIsPassivation(boolean replicationIsPassivation)
void	setTxSynchronized(boolean txSynchronized)
void	writeExternal(java.io.ObjectOutput out)

Methods inherited from class org.jboss.ejb3.session.SessionSpecBeanContext

createInjectionInvocation, createLifecycleInvocation

Methods inherited from class org.jboss.ejb3.BaseContext

getInterceptor, initialiseInterceptorInstances

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.jboss.ejb3.interceptors.container.BeanContext

getInterceptor

Field Detail

id

protected java.lang.Object id

txSynchronized

protected boolean txSynchronized

inInvocation

protected boolean inInvocation

beanMO

protected org.jboss.serial.io.MarshalledObject beanMO

lock

protected java.util.concurrent.locks.ReentrantLock lock

discarded

protected boolean discarded

propagatedContainedIn

public static ThreadLocalStack<StatefulBeanContext> propagatedContainedIn

currentBean

public static ThreadLocalStack<StatefulBeanContext> currentBean

containedIn

protected StatefulBeanContext containedIn

contains

protected java.util.List<StatefulBeanContext> contains

persistenceContexts

protected java.util.HashMap<java.lang.String,javax.persistence.EntityManager> persistenceContexts

removed

protected boolean removed

containerClusterUid

protected java.lang.String containerClusterUid

containerGuid

protected java.lang.String containerGuid

isClustered

protected boolean isClustered

replicationIsPassivation

protected boolean replicationIsPassivation

passivated

protected transient boolean passivated

markedForPassivation

public volatile boolean markedForPassivation

markedForReplication

public volatile boolean markedForReplication

lastUsed

public long lastUsed

Constructor Detail

StatefulBeanContext

protected StatefulBeanContext(StatefulContainer container,
                              org.jboss.serial.io.MarshalledObject beanMO)

An incoming context from serialization.

Parameters:

container -

beanMO -

StatefulBeanContext

protected StatefulBeanContext(StatefulContainer container,
                              java.lang.Object bean)

A brand new stateful session bean.

Parameters:

container -

bean -

StatefulBeanContext

public StatefulBeanContext()

Deprecated.

Only for use by externalization; do not use elsewhere.

Method Detail

discard

protected void discard()

getContains

public java.util.List<StatefulBeanContext> getContains()

getSessionSynchronization

protected javax.ejb.SessionSynchronization getSessionSynchronization()

getEJBContext

public org.jboss.ejb3.context.spi.EJBContext getEJBContext()

Specified by:

getEJBContext in class SessionBeanContext<StatefulContainer>

getExtendedPersistenceContext

public javax.persistence.EntityManager getExtendedPersistenceContext(java.lang.String id)

addExtendedPersistenceContext

public void addExtendedPersistenceContext(java.lang.String id,
                                          javax.persistence.EntityManager pc)

scanForExtendedPersistenceContext

public boolean scanForExtendedPersistenceContext(java.lang.String id,
                                                 StatefulBeanContext ignore)

removeExtendedPersistenceContext

public void removeExtendedPersistenceContext(java.lang.String id)

getExtendedPersistenceContexts

public java.util.Map<java.lang.String,javax.persistence.EntityManager> getExtendedPersistenceContexts()

getContainedIn

public StatefulBeanContext getContainedIn()

getUltimateContainedIn

public StatefulBeanContext getUltimateContainedIn()

addContains

public void addContains(StatefulBeanContext ctx)

removeContains

public void removeContains(StatefulBeanContext ctx)

pushContainedIn

public StatefulBeanContext pushContainedIn()

getCanPassivate

public boolean getCanPassivate()

Checks whether this context or any of its children are in use.

prePassivate

public void prePassivate()

Notification from a non-clustered StatefulCache to inform that we are about to be passivated.

postActivate

public void postActivate()

Notification from a non-clustered StatefulCache to inform that we have been activated.

passivateAfterReplication

public void passivateAfterReplication()

Notification from a ClusteredStatefulCache to inform that a bean that is stored in the distributed cache is now being passivated as well. Something of a misnomer as it is possible the bean wasn't replicated (if it implements Optimized it may have been activated and then a reference left in the cache without the bean ever being replicated).

activateAfterReplication

public void activateAfterReplication()

getReplicationIsPassivation

public boolean getReplicationIsPassivation()

setReplicationIsPassivation

public void setReplicationIsPassivation(boolean replicationIsPassivation)

preReplicate

public void preReplicate()

Notification from a ClusteredStatefulCache before a bean is replicated.

postReplicate

public void postReplicate()

Notification from a ClusteredStatefulCache after the bean is fetched from the distributed cache. Something of a misnomer as it is possible the bean wasn't replicated (if it implements Optimized it can be fetched from the cache twice without ever being replicated).

popContainedIn

public void popContainedIn()

isInUse

public boolean isInUse()

setInUse

public void setInUse(boolean inUse)

isDiscarded

public boolean isDiscarded()

setDiscarded

public void setDiscarded(boolean discarded)

getLock

public java.util.concurrent.locks.ReentrantLock getLock()

isInInvocation

public boolean isInInvocation()

setInInvocation

public void setInInvocation(boolean inInvocation)

getId

public java.lang.Object getId()

Specified by:

getId in interface org.jboss.ejb3.cache.Identifiable

Overrides:

getId in class BaseContext<StatefulContainer>

isTxSynchronized

public boolean isTxSynchronized()

setTxSynchronized

public void setTxSynchronized(boolean txSynchronized)

isRemoved

public boolean isRemoved()

remove

public void remove()

getCanRemoveFromCache

public boolean getCanRemoveFromCache()

getContainer

public StatefulContainer getContainer()

Overrides:

getContainer in class BaseContext<StatefulContainer>

getInstance

public java.lang.Object getInstance()

Description copied from class: BaseContext

Returns the enterprise bean, never returns null.

Specified by:

getInstance in interface org.jboss.ejb3.interceptors.container.BeanContext<java.lang.Object>

Overrides:

getInstance in class BaseContext<StatefulContainer>

isModified

public boolean isModified()

getMetaData

public org.jboss.aop.metadata.SimpleMetaData getMetaData()

Specified by:

getMetaData in interface org.jboss.ejb3.tx.container.StatefulBeanContext<java.lang.Object>

Overrides:

getMetaData in class BaseContext<StatefulContainer>

getInterceptorInstances

public java.lang.Object[] getInterceptorInstances(InterceptorInfo[] interceptorInfos)

Overrides:

getInterceptorInstances in class BaseContext<StatefulContainer>

extractBeanAndInterceptors

protected void extractBeanAndInterceptors()

writeExternal

public void writeExternal(java.io.ObjectOutput out)
                   throws java.io.IOException

Specified by:

writeExternal in interface java.io.Externalizable

Throws:

java.io.IOException

readExternal

public void readExternal(java.io.ObjectInput in)
                  throws java.io.IOException,
                         java.lang.ClassNotFoundException

Specified by:

readExternal in interface java.io.Externalizable

Throws:

java.io.IOException

java.lang.ClassNotFoundException

getInvokedMethodKey

public java.lang.Object getInvokedMethodKey()

Overrides:

getInvokedMethodKey in class BaseContext<StatefulContainer>

equals

public boolean equals(java.lang.Object obj)

Overrides:

equals in class java.lang.Object

hashCode

public int hashCode()

Overrides:

hashCode in class java.lang.Object

registerSynchronization

protected void registerSynchronization(javax.transaction.Transaction tx,
                                       javax.transaction.Synchronization sync)
                                throws java.lang.IllegalStateException,
                                       javax.transaction.RollbackException,
                                       javax.transaction.SystemException

To make sure Synchronizations are executed in a given order we maintain a sync registry within this object.

Parameters:

sync -

Throws:

java.lang.IllegalStateException

javax.transaction.RollbackException

javax.transaction.SystemException