Package 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>, org.jboss.as.server.suspend.ServerActivityCallback, PassivationListener<StatefulSessionComponentInstance>

public class StatefulSessionComponent
extends SessionBeanComponent
implements StatefulObjectFactory<StatefulSessionComponentInstance>, PassivationListener<StatefulSessionComponentInstance>

Stateful Session Bean

Author:

Carlo de Wolf

Field Summary

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

beanLevelAccessTimeout

Constructor Summary

Constructors

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

Method Summary

Modifier and Type	Method	Description
protected StatefulSessionComponentInstance	constructComponentInstance(ManagedReference instance, boolean invokePostConstruct)
protected StatefulSessionComponentInstance	constructComponentInstance(ManagedReference instance, boolean invokePostConstruct, Map<Object,Object> context)
StatefulSessionComponentInstance	createInstance()	Create a new instance of this component.
StatefulSessionComponentInstance	createInstance(Object instance)
protected void	createInterceptors(org.jboss.invocation.InterceptorFactoryContext context)
org.jboss.ejb.client.SessionID	createSession()
org.jboss.ejb.client.SessionID	createSessionRemote()	creates a session using the global request controller.
void	destroyInstance(StatefulSessionComponentInstance instance)	Destroy an instance of the component.
void	done()
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()
jakarta.ejb.EJBLocalObject	getEJBLocalObject(org.jboss.invocation.InterceptorContext ctx)
jakarta.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)
jakarta.ejb.TimerService	getTimerService()
void	init()
protected BasicComponentInstance	instantiateComponentInstance(org.jboss.invocation.Interceptor preDestroyInterceptor, Map<Method,org.jboss.invocation.Interceptor> methodInterceptors, Map<Object,Object> context)
boolean	isRemotable(Throwable throwable)
void	postActivate(StatefulSessionComponentInstance instance)
void	prePassivate(StatefulSessionComponentInstance instance)
void	removeSession(org.jboss.ejb.client.SessionID sessionId)	Removes the session associated with the sessionId.
boolean	shouldDiscard(Exception ex, Method method)

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, getComponentDescription, getControlPoint, getCurrentTransactionAttribute, getDistinctName, getEarApplicationName, getEJBHome, getEJBLocalHome, getEjbLocalObjectType, getEjbLocalObjectViewServiceName, getEjbObjectType, getEjbObjectViewServiceName, getEjbSuspendHandlerService, getIdentityOutflowFunction, getIncomingRunAsIdentity, getInvocationMetrics, getModuleName, getSecurityDomain, getSecurityMetaData, getShutDownInterceptorFactory, getTimeoutInterceptors, getTimeoutMethod, getTransactionAttributeType, getTransactionAttributeType, getTransactionAttributeType, getTransactionManager, getTransactionSynchronizationRegistry, getTransactionTimeout, getTransactionTimeout, getUserTransaction, isBeanManagedTransaction, isCallerInRole, isExceptionLoggingEnabled, isSecurityDomainKnown, isStatisticsEnabled, isTransactionAttributeTypeExplicit, lookup, setIncomingRunAsIdentity, stop

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

componentInstanceCreated, getComponentClass, getComponentName, getCreateServiceName, getInstance, getNamespaceContextSelector, serviceNameOf, start, toString, waitForComponentStart

Methods inherited from class java.lang.Object

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

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 interface: StatefulObjectFactory

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.

The instance has been injected and post-construct has been called.

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)

Specified by:

createInstance in interface Component

Overrides:

createInstance in class BasicComponent

constructComponentInstance

protected StatefulSessionComponentInstance constructComponentInstance(ManagedReference instance,
                                                                      boolean invokePostConstruct)

Overrides:

constructComponentInstance in class BasicComponent

constructComponentInstance

protected StatefulSessionComponentInstance constructComponentInstance(ManagedReference instance,
                                                                      boolean invokePostConstruct,
                                                                      Map<Object,Object> context)

Overrides:

constructComponentInstance in class BasicComponent

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 jakarta.ejb.EJBLocalObject getEJBLocalObject(org.jboss.invocation.InterceptorContext ctx)
                                             throws IllegalStateException

Overrides:

getEJBLocalObject in class SessionBeanComponent

Throws:

IllegalStateException

getEJBObject

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

Overrides:

getEJBObject in class SessionBeanComponent

Throws:

IllegalStateException

getTimerService

public jakarta.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()

createSessionRemote

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

creates a session using the global request controller. This should only be used by callers that service remote requests (i.e. places that represent a remote entry point into the container)

Returns:

The session id

getCache

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

instantiateComponentInstance

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

Overrides:

instantiateComponentInstance in class BasicComponent

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()

init

public void init()

Overrides:

init in class EJBComponent

createInterceptors

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

Overrides:

createInterceptors in class BasicComponent

done

public void done()

Specified by:

done in interface org.jboss.as.server.suspend.ServerActivityCallback

Overrides:

done in class EJBComponent

getAllowedMethodsInformation

public AllowedMethodsInformation getAllowedMethodsInformation()

Overrides:

getAllowedMethodsInformation in class EJBComponent

getSerialiableInterceptorContextKeys

public Set<Object> getSerialiableInterceptorContextKeys()

isRemotable

public boolean isRemotable(Throwable throwable)

Specified by:

isRemotable in interface Component

shouldDiscard

public boolean shouldDiscard(Exception ex,
                             Method method)