org.jboss.ejb
Interface ContainerInvoker

All Superinterfaces:

ContainerPlugin, Service

All Known Implementing Classes:

JMSContainerInvoker, JRMPContainerInvoker, JRMPContainerInvoker, JRMPContainerInvoker

public interface ContainerInvoker

extends ContainerPlugin

This is an interface for Container plugins. Implementations of this interface are responsible for receiving remote invocations of EJB's and to forward these requests to the Container it is being used with. It is responsible for providing any EJBObject and EJBHome implementations (which may be statically or dynamically created). Before forwarding a call to the container it must call Thread.setContextClassLoader() with the classloader of the container. It must also handle any propagated transaction and security contexts properly. It may acquire the TransactionManager from JNDI.

Version:

$Revision: 1.6 $

Author:

Rickard Öberg (rickard.oberg@telkel.com), Marc Fleury

See Also:

Container

Method Summary

javax.ejb.EJBHome	getEJBHome() This method is called whenever the EJBHome implementation for this container is needed.
javax.ejb.EJBMetaData	getEJBMetaData() This method is called whenever the metadata for this container is needed.
java.util.Collection	getEntityCollection(java.util.Collection enum) This method is called whenever a collection of EJBObjects for a collection of primary keys is needed.
javax.ejb.EJBObject	getEntityEJBObject(java.lang.Object id) This method is called whenever an EJBObject implementation for an entitybean is needed.
javax.ejb.EJBObject	getStatefulSessionEJBObject(java.lang.Object id) This method is called whenever an EJBObject implementation for a stateful session bean is needed.
javax.ejb.EJBObject	getStatelessSessionEJBObject() This method is called whenever an EJBObject implementation for a stateless session bean is needed.

Methods inherited from interface org.jboss.ejb.ContainerPlugin

setContainer

Methods inherited from interface org.jboss.util.Service

destroy, init, start, stop

Method Detail

getEJBMetaData

public javax.ejb.EJBMetaData getEJBMetaData()

This method is called whenever the metadata for this container is needed.

Returns:

an implementation of the EJBMetaData interface

getEJBHome

public javax.ejb.EJBHome getEJBHome()

This method is called whenever the EJBHome implementation for this container is needed.

Returns:

an implementation of the home interface for this container

getStatelessSessionEJBObject

public javax.ejb.EJBObject getStatelessSessionEJBObject()
                                                 throws java.rmi.RemoteException

This method is called whenever an EJBObject implementation for a stateless session bean is needed.

Returns:

an implementation of the remote interface for this container

Throws:

java.rmi.RemoteException - thrown if the EJBObject could not be created

getStatefulSessionEJBObject

public javax.ejb.EJBObject getStatefulSessionEJBObject(java.lang.Object id)
                                                throws java.rmi.RemoteException

This method is called whenever an EJBObject implementation for a stateful session bean is needed.

Parameters:

id - the id of the session

Returns:

an implementation of the remote interface for this container

Throws:

java.rmi.RemoteException - thrown if the EJBObject could not be created

getEntityEJBObject

public javax.ejb.EJBObject getEntityEJBObject(java.lang.Object id)
                                       throws java.rmi.RemoteException

This method is called whenever an EJBObject implementation for an entitybean is needed.

Parameters:

id - the primary key of the entity

Returns:

an implementation of the remote interface for this container

Throws:

java.rmi.RemoteException - thrown if the EJBObject could not be created

getEntityCollection

public java.util.Collection getEntityCollection(java.util.Collection enum)
                                         throws java.rmi.RemoteException

This method is called whenever a collection of EJBObjects for a collection of primary keys is needed.

Parameters:

enum - enumeration of primary keys

Returns:

a collection of EJBObjects implementing the remote interface for this container

Throws:

java.rmi.RemoteException - thrown if the EJBObjects could not be created