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, StatefulObjectFactory<StatefulSessionComponentInstance>, IdentifierFactory<org.jboss.ejb.client.SessionID>, PassivationListener<StatefulSessionComponentInstance>

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

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

Modifier and Type	Method and Description
protected StatefulSessionComponentInstance	constructComponentInstance(ManagedReference instance, boolean invokePostConstruct) Construct the component instance.
protected StatefulSessionComponentInstance	constructComponentInstance(ManagedReference instance, boolean invokePostConstruct, Map<Object,Object> context) Construct the component instance.
org.jboss.ejb.client.SessionID	createIdentifier()
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 void	createInterceptors(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.Interceptor	getAfterBegin()
Method	getAfterBeginMethod()
org.jboss.invocation.Interceptor	getAfterCompletion()
Method	getAfterCompletionMethod()
AllowedMethodsInformation	getAllowedMethodsInformation()
org.jboss.invocation.Interceptor	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.Interceptor	getEjb2XRemoveMethod()
javax.ejb.EJBLocalObject	getEJBLocalObject(org.jboss.invocation.InterceptorContext ctx)
javax.ejb.EJBObject	getEJBObject(org.jboss.invocation.InterceptorContext ctx)
org.jboss.invocation.Interceptor	getPostActivate()
org.jboss.invocation.Interceptor	getPrePassivate()
Set<Object>	getSerialiableInterceptorContextKeys()
protected org.jboss.ejb.client.SessionID	getSessionIdOf(org.jboss.invocation.InterceptorContext ctx)
javax.ejb.TimerService	getTimerService()
protected BasicComponentInstance	instantiateComponentInstance(org.jboss.invocation.Interceptor preDestroyInterceptor, Map<Method,org.jboss.invocation.Interceptor> methodInterceptors, Map<Object,Object> context) Responsible for instantiating the BasicComponentInstance.
void	postActivate(StatefulSessionComponentInstance instance)
void	prePassivate(StatefulSessionComponentInstance instance)
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() 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, getInvocationMetrics, getModuleName, getSecurityManager, getSecurityMetaData, getShutDownInterceptorFactory, getTimeoutInterceptors, getTimeoutMethod, getTransactionAttributeType, getTransactionAttributeType, getTransactionManager, getTransactionSynchronizationRegistry, getTransactionTimeout, getTransactionTimeout, getUserTransaction, isBeanManagedTransaction, isCallerInRole, isStatisticsEnabled, lookup

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

componentInstanceCreated, getComponentClass, getComponentName, getCreateServiceName, getNamespaceContextSelector, serviceNameOf, 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.

Specified by:

createInstance in interface Component

Overrides:

createInstance in class BasicComponent

Parameters:

instance - The instance to wrap

Returns:

The new ComponentInstance

constructComponentInstance

protected StatefulSessionComponentInstance constructComponentInstance(ManagedReference instance,
                                                                      boolean invokePostConstruct)

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

constructComponentInstance

protected StatefulSessionComponentInstance constructComponentInstance(ManagedReference instance,
                                                                      boolean invokePostConstruct,
                                                                      Map<Object,Object> 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)

Specified by:

postActivate in interface PassivationListener<StatefulSessionComponentInstance>

prePassivate

public void prePassivate(StatefulSessionComponentInstance instance)

Specified by:

prePassivate in interface PassivationListener<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

createSession

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

getCache

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

createIdentifier

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

Specified by:

createIdentifier in interface IdentifierFactory<org.jboss.ejb.client.SessionID>

instantiateComponentInstance

protected BasicComponentInstance instantiateComponentInstance(org.jboss.invocation.Interceptor preDestroyInterceptor,
                                                              Map<Method,org.jboss.invocation.Interceptor> methodInterceptors,
                                                              Map<Object,Object> context)

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(org.jboss.as.naming.ManagedReference, boolean).

Overrides:

instantiateComponentInstance in class BasicComponent

Returns:

the component 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.Interceptor getAfterBegin()

getAfterCompletion

public org.jboss.invocation.Interceptor getAfterCompletion()

getBeforeCompletion

public org.jboss.invocation.Interceptor getBeforeCompletion()

getAfterBeginMethod

public Method getAfterBeginMethod()

getAfterCompletionMethod

public Method getAfterCompletionMethod()

getBeforeCompletionMethod

public Method getBeforeCompletionMethod()

getPrePassivate

public org.jboss.invocation.Interceptor getPrePassivate()

getPostActivate

public org.jboss.invocation.Interceptor getPostActivate()

getEjb2XRemoveMethod

public org.jboss.invocation.Interceptor 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 EJBComponent

createInterceptors

protected void createInterceptors(org.jboss.invocation.InterceptorFactoryContext context)

Overrides:

createInterceptors in class BasicComponent

stop

public void stop()

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 EJBComponent

getAllowedMethodsInformation

public AllowedMethodsInformation getAllowedMethodsInformation()

Overrides:

getAllowedMethodsInformation in class EJBComponent

getSerialiableInterceptorContextKeys

public Set<Object> getSerialiableInterceptorContextKeys()