com.sun.ejb.containers

Class AbstractSingletonContainer

java.lang.Object

com.sun.ejb.containers.BaseContainer

com.sun.ejb.containers.AbstractSingletonContainer

All Implemented Interfaces:

Container, JavaEEContainer, EjbContainerFacade

Direct Known Subclasses:

BMCSingletonContainer, CMCSingletonContainer

public abstract class AbstractSingletonContainer
extends BaseContainer

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected class	AbstractSingletonContainer.SingletonContextFactory

Nested classes/interfaces inherited from class com.sun.ejb.containers.BaseContainer

BaseContainer.ContainerInfo, BaseContainer.ContainerType, BaseContainer.PreInvokeException

Field Summary

Fields

Modifier and Type	Field and Description
protected ClusteredSingletonLookup	clusteredLookup
protected ComponentContext	singletonCtx
protected ObjectFactory	singletonCtxFactory
protected boolean	singletonInitializationFailed
protected AtomicBoolean	singletonInitialized

Fields inherited from class com.sun.ejb.containers.BaseContainer

_logger, cacheProbeListener, cacheProbeNotifier, callFlowInfo, componentId, CONTAINER_INITIALIZING, CONTAINER_ON_HOLD, CONTAINER_STARTED, CONTAINER_STOPPED, CONTAINER_UNDEPLOYED, containerInfo, containerState, containerStateManager, containerTransactionManager, containerType, debugMonitorFlag, ejbActivateMethod, ejbClass, ejbContainerUtilImpl, ejbDescriptor, ejbGeneratedOptionalLocalBusinessIntfClass, ejbHome, ejbHomeImpl, ejbHomeStub, ejbIntfMethodInfo, ejbIntfMethods, ejbLocalBusinessHome, ejbLocalBusinessHomeImpl, ejbLocalHome, ejbLocalHomeImpl, EJBLocalObject_getPrimaryKey, EJBObject_getPrimaryKey, ejbOptionalLocalBusinessHome, ejbOptionalLocalBusinessHomeImpl, ejbOptionalLocalBusinessHomeIntf, ejbPassivateMethod, ejbProbeListener, ejbProbeNotifier, ejbRemoteBusinessHome, ejbRemoteBusinessHomeImpl, ejbRemoteBusinessHomeStub, ejbRemoveMethod, envProps, executorProbeListener, hasLocalBusinessView, hasLocalHomeView, hasOptionalLocalBusinessView, hasRemoteBusinessView, hasRemoteHomeView, homeIntf, injectionManager, interceptorManager, invocationInfoMap, invocationManager, isBeanManagedTran, isLocal, isMessageDriven, isRemote, isSession, isSingleton, isStatefulSession, isStatelessSession, isWebServiceEndpoint, jcdiService, loader, localBusinessHomeIntf, localBusinessIntfs, localHomeIntf, logParams, metadata, methodMonitorMap, monitorOn, namingManager, NO_PARAMS, optIntfClassLoader, poolProbeListener, remoteBusinessHomeIntf, remoteBusinessIntfInfo, remoteHomeRefFactory, remoteIntf, scheduleIds, securityManager, sfsbSerializedClass, SINGLETON_BEAN_POOL_PROP, timerProbeListener, timerProbeNotifier, transactionManager, webServiceEndpointIntf, webServiceInvocationInfoMap

Fields inherited from interface com.sun.ejb.Container

SEC_CHECKED, SEC_EXCLUDED, SEC_NOT_INITIALIZED, SEC_UNCHECKED, secAttrStrings, TX_BEAN_MANAGED, TX_MANDATORY, TX_NEVER, TX_NOT_INITIALIZED, TX_NOT_SUPPORTED, TX_REQUIRED, TX_REQUIRES_NEW, TX_SUPPORTS, txAttrStrings

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	AbstractSingletonContainer(EjbDescriptor desc, ClassLoader loader, SecurityManager sm) This constructor is called from the JarManager when a Jar is deployed.

Method Summary

Modifier and Type	Method and Description
protected EJBContextImpl	_constructEJBContextImpl(Object instance)
protected ComponentContext	_getContext(EjbInvocation invocation)
void	activateEJB(Object ctx, Object instanceKey)
protected void	afterBegin(EJBContextImpl context)
protected void	afterCompletion(EJBContextImpl ctx, int status)
protected void	beforeCompletion(EJBContextImpl context)
protected void	checkExists(EJBLocalRemoteObject ejbObj) Check if the given EJBObject/LocalObject has been removed.
protected void	checkInit()
protected EjbInvocation	createEjbInvocation()
protected EjbInvocation	createEjbInvocation(Object ejb, ComponentContext ctx)
EJBLocalObjectImpl	createEJBLocalBusinessObjectImpl(boolean localBeanView) Called during internal creation of session bean
EJBLocalObjectImpl	createEJBLocalObjectImpl() Called during client creation request through EJB LocalHome view.
EJBObjectImpl	createEJBObjectImpl()
EJBObjectImpl	createRemoteBusinessObjectImpl()
protected void	doConcreteContainerShutdown(boolean appBeingUndeployed) TODO public void appendStats(StringBuilder sbuf) { sbuf.append("\nSingletonContainer: ") .append("CreateCount=").append(statCreateCount).append("; ") .append("RemoveCount=").append(statRemoveCount).append("; ") .append("]"); }
protected void	doTimerInvocationInit(EjbInvocation inv, Object primaryKey) This is implemented by concrete containers that support TimedObjects.
protected void	forceDestroyBean(EJBContextImpl sc) Force destroy the EJB should be a no-op for singletons.
protected EJBLocalObjectImpl	getEJBLocalObjectImpl(Object key) Not applicable to Singletons
protected EJBObjectImpl	getEJBObjectImpl(byte[] instanceKey) Not applicable to Singletons
int	getMaxPoolSize()
long	getMethodReadyCount()
String	getMonitorAttributeValues()
protected EjbMonitoringStatsProvider	getMonitoringStatsProvider(String appName, String modName, String ejbName)
int	getSteadyPoolSize()
protected void	initializeHome() Called from the ContainerFactory during initialization.
ComponentContext	instantiateSingletonInstance()
void	onReady() Called when server instance is Ready
boolean	passivateEJB(ComponentContext context)
protected void	registerMonitorableComponents()
protected void	releaseContext(EjbInvocation inv)
protected void	removeBean(EJBLocalRemoteObject ejbo, Method removeMethod, boolean local)
void	setSingletonLifeCycleManager(SingletonLifeCycleManager lcm)
boolean	userTransactionMethodsAllowed(ComponentInvocation inv) EJB spec makes a distinction between access to the UserTransaction object itself and access to its methods.

Methods inherited from class com.sun.ejb.containers.BaseContainer

_constructEJBInstance, _createJCDIInjectionContext, _createJCDIInjectionContext, addInvocationInfo, addLocalRemoteInvocationInfo, addProxyInterfacesSetClass, adjustHomeTargetMethodInfo, adjustInvocationInfo, assertValidLocalObject, assertValidRemoteObject, authorize, authorizeLocalGetPrimaryKey, authorizeLocalMethod, authorizeRemoteGetPrimaryKey, authorizeRemoteMethod, callEJBTimeout, cancelTimers, checkExceptionClientTx, checkUnfinishedTx, checkUserTransactionLookup, cleanupInstance, containerStateToString, createCallFlowAgent, createEjbInstanceAndContext, createEjbInstanceForInterceptors, createEmptyContextAndInterceptors, createMonitoringRegistry, createRemoteReferenceWithId, delistExtendedEntityManagers, doAfterBegin, doEJBHomeRemove, doFlush, enlistExtendedEntityManagers, externalPostInvoke, externalPreInvoke, findFlushEnabledAttr, getApplicationId, getClassLoader, getComponentId, getContainerClassLoader, getContainerId, getContainerType, getContext, getDebugMonitorFlag, getDescriptor, getEJBClass, getEjbDescriptor, getEJBHome, getEJBHomeInvocationHandler, getEJBHomeStub, getEJBLocalBusinessHome, getEJBLocalHome, getEJBLocalHomeInvocationHandler, getEJBLocalObjectForPrimaryKey, getEJBLocalObjectForPrimaryKey, getEJBMetaData, getEJBObjectForPrimaryKey, getInvocationKey, getJaccEjb, getJavaGlobalJndiNamePrefix, getMonitoringMethodsArray, getMonitoringMethodsArray, getPassByReference, getPre30LifecycleMethodNames, getProtocolManager, getSecurityManager, getTargetObject, getTimeoutMethod, getTxAttr, getTxAttr, getTxAttrForLifecycleCallback, getUserTransaction, getUseThreadPoolId, incrementCreatedTimedObject, incrementDeliveredTimedObject, incrementRemovedTimedObject, initialize, initializeProtocolManager, injectEjbInstance, instantiateEJBLocalBusinessObjectImpl, instantiateEJBLocalObjectImpl, instantiateEJBLocalObjectImpl, instantiateEJBObjectImpl, instantiateEJBObjectImpl, instantiateOptionalEJBLocalBusinessObjectImpl, instantiateRemoteBusinessObjectImpl, intercept, intercept, invokeBeanMethod, invokeFindByPrimaryKey, invokeTargetBeanMethod, isApplicationException, isCreateHomeFinder, isEjbTimeoutMethod, isHAEnabled, isIdentical, isJCDIEnabled, isLocalInterfaceSupported, isLocalObject, isRemoteInterfaceSupported, isRemoteObject, isStopped, isSystemUncheckedException, isTimedObject, isUndeployed, lookupExtendedEntityManager, onEnteringContainer, onLeavingContainer, onShutdown, onTermination, postCreate, postEjbTimeout, postFind, postInvoke, postInvoke, postInvokeNoTx, postInvokeTx, postProcessInvocationInfo, preInitialize, preInvoke, preInvokeNoTx, preInvokeTx, prepareEjbTimeoutParams, preSelect, registerTimerMonitorableComponent, releaseTargetObject, removeBeanUnchecked, removeBeanUnchecked, resumeTransaction, scanForEjbCreateMethod, setDebugMonitorFlag, setEJBMetaData, setStartedState, setStoppedState, setUndeployedState, startApplication, suspendTransaction, toString, undeploy, useClientTx, validateEMForClientTx, validateTxAttr, webServicePostInvoke

Methods inherited from class java.lang.Object

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

Field Detail

singletonCtxFactory

protected ObjectFactory singletonCtxFactory

singletonInitialized

protected AtomicBoolean singletonInitialized

singletonInitializationFailed

protected boolean singletonInitializationFailed

singletonCtx

protected volatile ComponentContext singletonCtx

clusteredLookup

protected final ClusteredSingletonLookup clusteredLookup

Constructor Detail

AbstractSingletonContainer

protected AbstractSingletonContainer(EjbDescriptor desc,
                                     ClassLoader loader,
                                     SecurityManager sm)
                              throws Exception

This constructor is called from the JarManager when a Jar is deployed.

Throws:

Exception - on error

Method Detail

getMonitorAttributeValues

public String getMonitorAttributeValues()

createEjbInvocation

protected EjbInvocation createEjbInvocation(Object ejb,
                                            ComponentContext ctx)

Overrides:

createEjbInvocation in class BaseContainer

createEjbInvocation

protected EjbInvocation createEjbInvocation()

Overrides:

createEjbInvocation in class BaseContainer

_getContext

protected ComponentContext _getContext(EjbInvocation invocation)
                                throws javax.ejb.EJBException

Specified by:

_getContext in class BaseContainer

Throws:

javax.ejb.EJBException

releaseContext

protected void releaseContext(EjbInvocation inv)
                       throws javax.ejb.EJBException

Specified by:

releaseContext in class BaseContainer

Throws:

javax.ejb.EJBException

initializeHome

protected void initializeHome()
                       throws Exception

Description copied from class: BaseContainer

Called from the ContainerFactory during initialization.

Overrides:

initializeHome in class BaseContainer

Throws:

Exception

registerMonitorableComponents

protected void registerMonitorableComponents()

Overrides:

registerMonitorableComponents in class BaseContainer

getMonitoringStatsProvider

protected EjbMonitoringStatsProvider getMonitoringStatsProvider(String appName,
                                                                String modName,
                                                                String ejbName)

Specified by:

getMonitoringStatsProvider in class BaseContainer

onReady

public void onReady()

Description copied from class: BaseContainer

Called when server instance is Ready

Specified by:

onReady in interface Container

Overrides:

onReady in class BaseContainer

createRemoteBusinessObjectImpl

public EJBObjectImpl createRemoteBusinessObjectImpl()
                                             throws javax.ejb.CreateException,
                                                    RemoteException

Throws:

javax.ejb.CreateException

RemoteException

createEJBObjectImpl

public EJBObjectImpl createEJBObjectImpl()
                                  throws javax.ejb.CreateException,
                                         RemoteException

Specified by:

createEJBObjectImpl in class BaseContainer

Throws:

javax.ejb.CreateException

RemoteException

createEJBLocalObjectImpl

public EJBLocalObjectImpl createEJBLocalObjectImpl()
                                            throws javax.ejb.CreateException

Called during client creation request through EJB LocalHome view.

Overrides:

createEJBLocalObjectImpl in class BaseContainer

Throws:

javax.ejb.CreateException

createEJBLocalBusinessObjectImpl

public EJBLocalObjectImpl createEJBLocalBusinessObjectImpl(boolean localBeanView)
                                                    throws javax.ejb.CreateException

Called during internal creation of session bean

Throws:

javax.ejb.CreateException

removeBean

protected void removeBean(EJBLocalRemoteObject ejbo,
                          Method removeMethod,
                          boolean local)
                   throws javax.ejb.RemoveException,
                          javax.ejb.EJBException,
                          RemoteException

Specified by:

removeBean in class BaseContainer

Throws:

javax.ejb.RemoveException

javax.ejb.EJBException

RemoteException

forceDestroyBean

protected void forceDestroyBean(EJBContextImpl sc)

Force destroy the EJB should be a no-op for singletons. After Initialization completes successfully, runtime exceptions during invocations on the Singleton do not result in the instance being destroyed.

Specified by:

forceDestroyBean in class BaseContainer

getEJBObjectImpl

protected EJBObjectImpl getEJBObjectImpl(byte[] instanceKey)

Not applicable to Singletons

Specified by:

getEJBObjectImpl in class BaseContainer

getEJBLocalObjectImpl

protected EJBLocalObjectImpl getEJBLocalObjectImpl(Object key)

Not applicable to Singletons

Overrides:

getEJBLocalObjectImpl in class BaseContainer

setSingletonLifeCycleManager

public void setSingletonLifeCycleManager(SingletonLifeCycleManager lcm)

checkInit

protected void checkInit()

instantiateSingletonInstance

public ComponentContext instantiateSingletonInstance()

_constructEJBContextImpl

protected EJBContextImpl _constructEJBContextImpl(Object instance)

Overrides:

_constructEJBContextImpl in class BaseContainer

doTimerInvocationInit

protected void doTimerInvocationInit(EjbInvocation inv,
                                     Object primaryKey)
                              throws Exception

Description copied from class: BaseContainer

This is implemented by concrete containers that support TimedObjects.

Overrides:

doTimerInvocationInit in class BaseContainer

Throws:

Exception

userTransactionMethodsAllowed

public boolean userTransactionMethodsAllowed(ComponentInvocation inv)

Description copied from class: BaseContainer

EJB spec makes a distinction between access to the UserTransaction object itself and access to its methods. getUserTransaction covers the first check and this method covers the second. It is called by the UserTransaction implementation to verify access.

Specified by:

userTransactionMethodsAllowed in interface Container

Overrides:

userTransactionMethodsAllowed in class BaseContainer

checkExists

protected void checkExists(EJBLocalRemoteObject ejbObj)

Check if the given EJBObject/LocalObject has been removed.

Overrides:

checkExists in class BaseContainer

Throws:

javax.ejb.NoSuchObjectLocalException - if the object has been removed.

afterBegin

protected void afterBegin(EJBContextImpl context)

Specified by:

afterBegin in class BaseContainer

beforeCompletion

protected void beforeCompletion(EJBContextImpl context)

Specified by:

beforeCompletion in class BaseContainer

afterCompletion

protected void afterCompletion(EJBContextImpl ctx,
                               int status)

Specified by:

afterCompletion in class BaseContainer

passivateEJB

public boolean passivateEJB(ComponentContext context)

Specified by:

passivateEJB in class BaseContainer

activateEJB

public void activateEJB(Object ctx,
                        Object instanceKey)

doConcreteContainerShutdown

protected void doConcreteContainerShutdown(boolean appBeingUndeployed)

TODO public void appendStats(StringBuilder sbuf) { sbuf.append("\nSingletonContainer: ") .append("CreateCount=").append(statCreateCount).append("; ") .append("RemoveCount=").append(statRemoveCount).append("; ") .append("]"); }

Specified by:

doConcreteContainerShutdown in class BaseContainer

getMethodReadyCount

public long getMethodReadyCount()

getMaxPoolSize

public int getMaxPoolSize()

getSteadyPoolSize

public int getSteadyPoolSize()