EntityContainer (JBoss Server API) - JBoss 4.0.1 sp1 server API Documentation 英文版文档

Overview

Package

Class

Use

Tree

Deprecated

Index

Help

PREV CLASS NEXT CLASS

FRAMES NO FRAMES

SUMMARY: NESTED | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

org.jboss.ejb
Class EntityContainer

java.lang.Object
  org.jboss.mx.util.JBossNotificationBroadcasterSupport
      org.jboss.system.ServiceMBeanSupport
          org.jboss.ejb.Container
              org.jboss.ejb.EntityContainer

All Implemented Interfaces:: AllowedOperationsFlags, ContainerMBean, EJBProxyFactoryContainer, EntityContainerMBean, InstancePoolContainer, javax.management.MBeanRegistration, javax.management.NotificationBroadcaster, javax.management.NotificationEmitter, org.jboss.system.Service, org.jboss.system.ServiceMBean

public class EntityContainer
extends Container
implements EJBProxyFactoryContainer, InstancePoolContainer, EntityContainerMBean

This is a Container for EntityBeans (both BMP and CMP).

Version:: $Revision: 1.126 $
Author:: Rickard 锟絙erg, Marc Fleury, Sebastien Alborini, Daniel OConnor, Bill Burke, Andreas Schaefer, Dain Sundstrom
See Also:: Container, EntityEnterpriseContext

Nested Class Summary

Nested classes inherited from class org.jboss.ejb.Container

Container.AbstractContainerInterceptor

Field Summary

protected Map beanMapping
          These are the mappings between the remote/local interface methods and the bean methods.

protected static GlobalTxEntityMap globalTxEntityMap
          This provides a way to find the entities that are part of a given transaction EntitySynchronizationInterceptor and InstanceSynchronization manage this instance.

protected Map homeMapping
          These are the mappings between the home interface methods and the container methods.

protected InstanceCache instanceCache
          This is the instance cache for this container

protected InstancePool instancePool
          This is the instancepool that is to be used

protected Interceptor interceptor
          This is the first interceptor in the chain.

protected EntityPersistenceManager persistenceManager
          This is the persistence manager for this container

protected boolean readOnly
          readOnly determines if state can be written to resource manager.

Fields inherited from class org.jboss.ejb.Container

BASE_EJB_CONTAINER_NAME, beanClass, classLoader, createCount, EJB_CONTAINER_QUERY_NAME, EJB_TIMEOUT, ejbModule, EJBOBJECT_REMOVE, homeInterface, invokeStats, jaccContextID, localClassLoader, localHomeInterface, localInterface, localProxyFactory, lockManager, marshalledInvocationMapping, metaData, ORB_NAME, proxyFactories, proxyFactoryTL, remoteInterface, removeCount, rm, securityProxy, sm, tm, webClassLoader

Fields inherited from class org.jboss.system.ServiceMBeanSupport

log, server, SERVICE_CONTROLLER_SIG, serviceName

Fields inherited from interface org.jboss.system.ServiceMBean

CREATE_EVENT, CREATED, DESTROY_EVENT, DESTROYED, FAILED, REGISTERED, START_EVENT, STARTED, STARTING, states, STOP_EVENT, STOPPED, STOPPING, UNREGISTERED

Fields inherited from interface org.jboss.ejb.AllowedOperationsFlags

IN_AFTER_BEGIN, IN_AFTER_COMPLETION, IN_BEFORE_COMPLETION, IN_BUSINESS_METHOD, IN_EJB_ACTIVATE, IN_EJB_CREATE, IN_EJB_FIND, IN_EJB_HOME, IN_EJB_LOAD, IN_EJB_PASSIVATE, IN_EJB_POST_CREATE, IN_EJB_REMOVE, IN_EJB_STORE, IN_EJB_TIMEOUT, IN_INTERCEPTOR_METHOD, IN_SERVICE_ENDPOINT_METHOD, IN_SET_ENTITY_CONTEXT, IN_SET_MESSAGE_DRIVEN_CONTEXT, IN_SET_SESSION_CONTEXT, IN_UNSET_ENTITY_CONTEXT, NOT_ALLOWED

Constructor Summary

EntityContainer()


Method Summary

void addInterceptor(Interceptor in)


protected void checkCoherency()


Object createBeanClassInstance()
          Returns a new instance of the bean class or a subclass of the bean class.

javax.ejb.EJBObject createHome(Invocation mi)
          This method takes care of the wiring of the "EJBObject" trio (target, context, proxy).

javax.ejb.EJBLocalObject createLocalHome(Invocation mi)
          Local home interface implementation

protected void createService()
          The EJBDeployer calls this method.

protected void destroyService()
          A default implementation of destroying the container service (no-op).

Object find(Invocation mi)
          This methods finds the target instances by delegating to the persistence manager It then manufactures EJBObject for all the involved instances found.

Object findLocal(Invocation mi)


void flushCache()
          Flush the cache

long getCacheSize()


javax.ejb.EJBHome getEJBHome(Invocation mi)


javax.ejb.EJBLocalHome getEJBLocalHome(Invocation mi)
          MF FIXME these are implemented on the client

javax.ejb.EJBMetaData getEJBMetaDataHome(Invocation mi)


javax.ejb.EJBObject getEJBObject(Invocation mi)
          A method for the getEJBObject from the handle

static GlobalTxEntityMap getGlobalTxEntityMap()


javax.ejb.Handle getHandle(Invocation mi)


Class getHomeClass()
          ???

javax.ejb.HomeHandle getHomeHandleHome(Invocation mi)


InstanceCache getInstanceCache()


InstancePool getInstancePool()
          Get the instance pool for the container.

Interceptor getInterceptor()


LocalProxyFactory getLocalProxyFactory()
          ???

EntityPersistenceManager getPersistenceManager()


Object getPrimaryKey(Invocation mi)


Class getRemoteClass()
          ???

Object internalInvoke(Invocation mi)
          This method is called when a method call comes in on an EJBObject.

Object internalInvokeHome(Invocation mi)
          This method is called when a method call comes in on the Home object.

void invokeEjbStore(EntityEnterpriseContext ctx)
          Invokes ejbStore method on the instance

boolean isIdentical(Invocation mi)


boolean isReadOnly()


void postCreateHome(Invocation mi)
          Delegates to the persistence manager postCreateEntityMethod.

void postCreateLocalHome(Invocation mi)
          Delegates to the persistence manager postCreateEntityMethod.

void remove(Invocation mi)


void removeHome(Invocation mi)


void removeLocalHome(Invocation mi)


void resetStatistic()


Map retrieveStatistic()


void setInstanceCache(InstanceCache ic)


void setInstancePool(InstancePool ip)


void setPersistenceManager(EntityPersistenceManager pm)


protected void setupBeanMapping()


protected void setupHomeMapping()


protected void setupMarshalledInvocationMapping()


protected void startService()
          A default implementation of starting the container service.

protected void stopService()
          A default implementation of stopping the container service (no-op).

void storeEntity(EntityEnterpriseContext ctx)
          For CMP actually stores the instance

static void synchronizeEntitiesWithinTransaction(Transaction tx)
          Stores all of the entities associated with the specified transaction.

Methods inherited from class org.jboss.ejb.Container

addProxyFactory, getBeanClass, getBeanMetaData, getClassLoader, getCreateCount, getDeploymentInfo, getEjbModule, getEnvContext, getInvokeStats, getJaccContextID, getJmxName, getLocalClass, getLocalClassLoader, getLocalHomeClass, getLockManager, getMessageDestination, getMethodPermissions, getProxyFactory, getRealmMapping, getRemoveCount, getSecurityManager, getSecurityProxy, getTimerService, getTransactionManager, getWebClassLoader, invoke, isCallByValue, lookupProxyFactory, removeTimerService, setBeanMetaData, setClassLoader, setDeploymentInfo, setEjbModule, setJaccContextID, setLocalClassLoader, setLockManager, setProxyFactory, setRealmMapping, setSecurityManager, setSecurityProxy, setTransactionManager, setWebClassLoader

Methods inherited from class org.jboss.system.ServiceMBeanSupport

create, destroy, getLog, getName, getNextNotificationSequenceNumber, getObjectName, getServer, getServiceName, getState, getStateString, jbossInternalCreate, jbossInternalDescription, jbossInternalDestroy, jbossInternalLifecycle, jbossInternalStart, jbossInternalStop, postDeregister, postRegister, preDeregister, preRegister, start, stop

Methods inherited from class org.jboss.mx.util.JBossNotificationBroadcasterSupport

addNotificationListener, getNotificationInfo, handleNotification, removeNotificationListener, removeNotificationListener, sendNotification

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.jboss.ejb.EJBProxyFactoryContainer

getLocalClass, getLocalHomeClass, getProxyFactory

Methods inherited from interface org.jboss.ejb.ContainerMBean

getBeanMetaData, getCreateCount, getEjbModule, getEnvContext, getInvokeStats, getRemoveCount, getTimerService, invoke, removeTimerService

Methods inherited from interface org.jboss.system.ServiceMBean

getName, getState, getStateString, jbossInternalLifecycle

Methods inherited from interface org.jboss.system.Service

create, destroy, start, stop

Field Detail

homeMapping

protected Map homeMapping

These are the mappings between the home interface methods and the container methods.

beanMapping

protected Map beanMapping

These are the mappings between the remote/local interface methods and the bean methods.

persistenceManager

protected EntityPersistenceManager persistenceManager

This is the persistence manager for this container

instanceCache

protected InstanceCache instanceCache

This is the instance cache for this container

instancePool

protected InstancePool instancePool

This is the instancepool that is to be used

interceptor

protected Interceptor interceptor

This is the first interceptor in the chain. The last interceptor must be provided by the container itself.

readOnly

protected boolean readOnly

readOnly determines if state can be written to resource manager.

globalTxEntityMap

protected static GlobalTxEntityMap globalTxEntityMap

This provides a way to find the entities that are part of a given transaction EntitySynchronizationInterceptor and InstanceSynchronization manage this instance.

Constructor Detail

EntityContainer

public EntityContainer()

Method Detail

getGlobalTxEntityMap

public static GlobalTxEntityMap getGlobalTxEntityMap()

synchronizeEntitiesWithinTransaction

public static void synchronizeEntitiesWithinTransaction(Transaction tx)

Stores all of the entities associated with the specified transaction. As per the spec 9.6.4, entities must be synchronized with the datastore when an ejbFind is called. Also, all entities within entire transaction should be synchronized before a remove, otherwise there may be problems with 'cascade delete'.

Parameters:: tx - the transaction that associated entites will be stored

isReadOnly

public boolean isReadOnly()

getLocalProxyFactory

public LocalProxyFactory getLocalProxyFactory()

Description copied from interface: EJBProxyFactoryContainer

???

Specified by:: getLocalProxyFactory in interface EJBProxyFactoryContainer

Returns:: ???

setInstancePool

public void setInstancePool(InstancePool ip)

getInstancePool

public InstancePool getInstancePool()

Description copied from interface: InstancePoolContainer

Get the instance pool for the container.

Specified by:: getInstancePool in interface InstancePoolContainer

Returns:: The instance pool for the container.

setInstanceCache

public void setInstanceCache(InstanceCache ic)

getInstanceCache

public InstanceCache getInstanceCache()

getPersistenceManager

public EntityPersistenceManager getPersistenceManager()

setPersistenceManager

public void setPersistenceManager(EntityPersistenceManager pm)

addInterceptor

public void addInterceptor(Interceptor in)

Specified by:: addInterceptor in class Container

getInterceptor

public Interceptor getInterceptor()

getHomeClass

public Class getHomeClass()

Description copied from interface: EJBProxyFactoryContainer

???

Specified by:: getHomeClass in interface EJBProxyFactoryContainer
Overrides:: getHomeClass in class Container

getRemoteClass

public Class getRemoteClass()

Description copied from interface: EJBProxyFactoryContainer

???

Specified by:: getRemoteClass in interface EJBProxyFactoryContainer
Overrides:: getRemoteClass in class Container

createBeanClassInstance

public Object createBeanClassInstance()
                               throws Exception

Returns a new instance of the bean class or a subclass of the bean class. If this is 1.x cmp, simply return a new instance of the bean class. If this is 2.x cmp, return a subclass that provides an implementation of the abstract accessors.

Overrides:: createBeanClassInstance in class Container

Returns:: The new instance.
Throws:: Exception
See Also:: Class.newInstance()