org.jboss.as.ejb3.component.stateful

Class StatefulSessionComponent

java.lang.Object

org.jboss.as.ee.component.BasicComponent

org.jboss.as.ejb3.component.EJBComponent

org.jboss.as.ejb3.component.session.SessionBeanComponent

org.jboss.as.ejb3.component.stateful.StatefulSessionComponent

All Implemented Interfaces:

Component, PassivationManager<org.jboss.ejb.client.SessionID,StatefulSessionComponentInstance>, StatefulObjectFactory<StatefulSessionComponentInstance>

public class StatefulSessionComponent
extends SessionBeanComponent
implements StatefulObjectFactory<StatefulSessionComponentInstance>, PassivationManager<org.jboss.ejb.client.SessionID,StatefulSessionComponentInstance>

Stateful Session Bean

Author:

Carlo de Wolf

Field Summary

Fields

Modifier and Type	Field and Description
static Object	SESSION_ID_REFERENCE_KEY

Fields inherited from class org.jboss.as.ejb3.component.session.SessionBeanComponent

beanLevelAccessTimeout

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	StatefulSessionComponent(StatefulSessionComponentCreateService ejbComponentCreateService) Construct a new instance.

Method Summary

Methods

Modifier and Type	Method and Description
protected void	componentInstanceCreated(BasicComponentInstance basicComponentInstance, org.jboss.invocation.InterceptorFactoryContext context) Method that can be overridden to perform setup on the instance after it has been created
protected StatefulSessionComponentInstance	constructComponentInstance(ManagedReference instance, boolean invokePostConstruct, org.jboss.invocation.InterceptorFactoryContext context) Construct the component instance.
StatefulSessionComponentInstance	createInstance() Create a new instance of this component.
StatefulSessionComponentInstance	createInstance(Object instance) Wraps an existing object instance in a ComponentInstance, and run the post construct interceptor chain on it.
protected org.jboss.invocation.Interceptor	createInterceptor(org.jboss.invocation.InterceptorFactory factory, org.jboss.invocation.InterceptorFactoryContext context)
org.jboss.ejb.client.SessionID	createSession()
void	destroyInstance(StatefulSessionComponentInstance instance) Destroy an instance of the component.
AccessTimeoutDetails	getAccessTimeout(Method method) Returns the AccessTimeout applicable to given method
org.jboss.invocation.InterceptorFactory	getAfterBegin()
Method	getAfterBeginMethod()
org.jboss.invocation.InterceptorFactory	getAfterCompletion()
Method	getAfterCompletionMethod()
AllowedMethodsInformation	getAllowedMethodsInformation()
org.jboss.invocation.InterceptorFactory	getBeforeCompletion()
Method	getBeforeCompletionMethod()
<T> T	getBusinessObject(Class<T> businessInterface, org.jboss.invocation.InterceptorContext context)
Cache<org.jboss.ejb.client.SessionID,StatefulSessionComponentInstance>	getCache()
org.jboss.invocation.InterceptorFactory	getEjb2XRemoveMethod()
javax.ejb.EJBLocalObject	getEJBLocalObject(org.jboss.invocation.InterceptorContext ctx)
javax.ejb.EJBObject	getEJBObject(org.jboss.invocation.InterceptorContext ctx)
org.jboss.marshalling.MarshallingConfiguration	getMarshallingConfiguration()
org.jboss.invocation.InterceptorFactory	getPostActivate()
org.jboss.invocation.InterceptorFactory	getPrePassivate()
Set<Object>	getSerialiableInterceptorContextKeys()
protected org.jboss.ejb.client.SessionID	getSessionIdOf(org.jboss.invocation.InterceptorContext ctx)
javax.ejb.TimerService	getTimerService()
protected BasicComponentInstance	instantiateComponentInstance(AtomicReference<ManagedReference> instanceReference, org.jboss.invocation.Interceptor preDestroyInterceptor, Map<Method,org.jboss.invocation.Interceptor> methodInterceptors, org.jboss.invocation.InterceptorFactoryContext interceptorContext) Responsible for instantiating the BasicComponentInstance.
void	postActivate(StatefulSessionComponentInstance instance) This method is called after an object has been retrieved deserialized after passivation.
void	prePassivate(StatefulSessionComponentInstance instance) This method is called before an object is serialized for passivation.
void	removeSession(org.jboss.ejb.client.SessionID sessionId) Removes the session associated with the sessionId.
void	start() Start operation called when the Component is available.
void	stop(org.jboss.msc.service.StopContext stopContext) Stop operation called when the Component is no longer available.

Methods inherited from class org.jboss.as.ejb3.component.session.SessionBeanComponent

getAsynchronousExecutor, getRollbackOnly, setRollbackOnly

Methods inherited from class org.jboss.as.ejb3.component.EJBComponent

createViewInstanceProxy, createViewInstanceProxy, getApplicationException, getApplicationName, getCallerPrincipal, getCurrentTransactionAttribute, getDistinctName, getEarApplicationName, getEJBHome, getEjbHomeViewServiceName, getEJBLocalHome, getEjbLocalHomeViewServiceName, getEjbLocalObjectType, getEjbLocalObjectViewServiceName, getEjbObjectType, getEjbObjectViewServiceName, getEjbRemoteTransactionsRepository, getModuleName, getSecurityManager, getSecurityMetaData, getTimeoutInterceptors, getTimeoutMethod, getTransactionAttributeType, getTransactionManager, getTransactionSynchronizationRegistry, getTransactionTimeout, getUserTransaction, isCallerInRole, lookup

Methods inherited from class org.jboss.as.ee.component.BasicComponent

getComponentClass, getComponentName, getCreateServiceName, getNamespaceContextSelector, toString, waitForComponentStart

Methods inherited from class java.lang.Object

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

Field Detail

SESSION_ID_REFERENCE_KEY

public static final Object SESSION_ID_REFERENCE_KEY

Constructor Detail

StatefulSessionComponent

protected StatefulSessionComponent(StatefulSessionComponentCreateService ejbComponentCreateService)

Construct a new instance.

Parameters:

ejbComponentCreateService - the component configuration

Method Detail

createInstance

public StatefulSessionComponentInstance createInstance()

Description copied from class: BasicComponent

Create a new instance of this component. This may be invoked by a component interceptor, a client interceptor, or in the course of creating a new client, or in the case of an "eager" singleton, at component start. This method will block until the component is available. If the component fails to start then a runtime exception will be thrown.

Specified by:

createInstance in interface Component

Specified by:

createInstance in interface StatefulObjectFactory<StatefulSessionComponentInstance>

Overrides:

createInstance in class BasicComponent

Returns:

the component instance

createInstance

public StatefulSessionComponentInstance createInstance(Object instance)

Description copied from class: BasicComponent

Wraps an existing object instance in a ComponentInstance, and run the post construct interceptor chain on it.

Overrides:

createInstance in class BasicComponent

Parameters:

instance - The instance to wrap

Returns:

The new ComponentInstance

constructComponentInstance

protected StatefulSessionComponentInstance constructComponentInstance(ManagedReference instance,
                                                          boolean invokePostConstruct,
                                                          org.jboss.invocation.InterceptorFactoryContext context)

Description copied from class: BasicComponent

Construct the component instance. Upon return, the object instance should have injections and lifecycle invocations completed already.

Overrides:

constructComponentInstance in class BasicComponent

Parameters:

instance - An instance to be wrapped, or null if a new instance should be created

Returns:

the component instance

destroyInstance

public void destroyInstance(StatefulSessionComponentInstance instance)

Description copied from interface: StatefulObjectFactory

Destroy an instance of the component. This method causes all uninjection and pre-destroy lifecycle invocations to occur.

Specified by:

destroyInstance in interface StatefulObjectFactory<StatefulSessionComponentInstance>

Parameters:

instance - the instance to destroy

postActivate

public void postActivate(StatefulSessionComponentInstance instance)

Description copied from interface: PassivationManager

This method is called after an object has been retrieved deserialized after passivation.

Specified by:

postActivate in interface PassivationManager<org.jboss.ejb.client.SessionID,StatefulSessionComponentInstance>

Parameters:

instance - the object

prePassivate

public void prePassivate(StatefulSessionComponentInstance instance)

Description copied from interface: PassivationManager

This method is called before an object is serialized for passivation.

Specified by:

prePassivate in interface PassivationManager<org.jboss.ejb.client.SessionID,StatefulSessionComponentInstance>

Parameters:

instance - the object

getMarshallingConfiguration

public org.jboss.marshalling.MarshallingConfiguration getMarshallingConfiguration()

Specified by:

getMarshallingConfiguration in interface PassivationManager<org.jboss.ejb.client.SessionID,StatefulSessionComponentInstance>

getSessionIdOf

protected org.jboss.ejb.client.SessionID getSessionIdOf(org.jboss.invocation.InterceptorContext ctx)

getBusinessObject

public <T> T getBusinessObject(Class<T> businessInterface,
                      org.jboss.invocation.InterceptorContext context)
                    throws IllegalStateException

Overrides:

getBusinessObject in class SessionBeanComponent

Throws:

IllegalStateException

getEJBLocalObject

public javax.ejb.EJBLocalObject getEJBLocalObject(org.jboss.invocation.InterceptorContext ctx)
                                           throws IllegalStateException

Overrides:

getEJBLocalObject in class SessionBeanComponent

Throws:

IllegalStateException

getEJBObject

public javax.ejb.EJBObject getEJBObject(org.jboss.invocation.InterceptorContext ctx)
                                 throws IllegalStateException

Overrides:

getEJBObject in class SessionBeanComponent

Throws:

IllegalStateException

getTimerService

public javax.ejb.TimerService getTimerService()
                                       throws IllegalStateException

Overrides:

getTimerService in class EJBComponent

Throws:

IllegalStateException

getAccessTimeout

public AccessTimeoutDetails getAccessTimeout(Method method)

Returns the AccessTimeout applicable to given method

createInterceptor

protected org.jboss.invocation.Interceptor createInterceptor(org.jboss.invocation.InterceptorFactory factory,
                                                 org.jboss.invocation.InterceptorFactoryContext context)

createSession

public org.jboss.ejb.client.SessionID createSession()

getCache

public Cache<org.jboss.ejb.client.SessionID,StatefulSessionComponentInstance> getCache()

instantiateComponentInstance

protected BasicComponentInstance instantiateComponentInstance(AtomicReference<ManagedReference> instanceReference,
                                                  org.jboss.invocation.Interceptor preDestroyInterceptor,
                                                  Map<Method,org.jboss.invocation.Interceptor> methodInterceptors,
                                                  org.jboss.invocation.InterceptorFactoryContext interceptorContext)

Description copied from class: BasicComponent

Responsible for instantiating the BasicComponentInstance. This method is *not* responsible for handling the post construct activities like injection and lifecycle invocation. That is handled by BasicComponent.constructComponentInstance(ManagedReference, boolean, InterceptorFactoryContext).

Overrides:

instantiateComponentInstance in class BasicComponent

Returns:

componentInstanceCreated

protected void componentInstanceCreated(BasicComponentInstance basicComponentInstance,
                            org.jboss.invocation.InterceptorFactoryContext context)

Description copied from class: BasicComponent

Method that can be overridden to perform setup on the instance after it has been created

Overrides:

componentInstanceCreated in class BasicComponent

Parameters:

basicComponentInstance - The component instance

context - The interceptor factory context used to construct the instance

removeSession

public void removeSession(org.jboss.ejb.client.SessionID sessionId)

Removes the session associated with the sessionId.

Parameters:

sessionId - The session id

getAfterBegin

public org.jboss.invocation.InterceptorFactory getAfterBegin()

getAfterCompletion

public org.jboss.invocation.InterceptorFactory getAfterCompletion()

getBeforeCompletion

public org.jboss.invocation.InterceptorFactory getBeforeCompletion()

getAfterBeginMethod

public Method getAfterBeginMethod()

getAfterCompletionMethod

public Method getAfterCompletionMethod()

getBeforeCompletionMethod

public Method getBeforeCompletionMethod()

getPrePassivate

public org.jboss.invocation.InterceptorFactory getPrePassivate()

getPostActivate

public org.jboss.invocation.InterceptorFactory getPostActivate()

getEjb2XRemoveMethod

public org.jboss.invocation.InterceptorFactory getEjb2XRemoveMethod()

start

public void start()

Description copied from class: BasicComponent

Start operation called when the Component is available.

Specified by:

start in interface Component

Overrides:

start in class BasicComponent

stop

public void stop(org.jboss.msc.service.StopContext stopContext)

Description copied from class: BasicComponent

Stop operation called when the Component is no longer available.

Specified by:

stop in interface Component

Overrides:

stop in class BasicComponent

Parameters:

stopContext - the stop context for the component service

getAllowedMethodsInformation

public AllowedMethodsInformation getAllowedMethodsInformation()

Overrides:

getAllowedMethodsInformation in class EJBComponent

getSerialiableInterceptorContextKeys

public Set<Object> getSerialiableInterceptorContextKeys()