org.glassfish.enterprise.iiop.impl

Class POARemoteReferenceFactory

java.lang.Object

org.omg.CORBA.LocalObject

org.glassfish.enterprise.iiop.impl.POARemoteReferenceFactory

All Implemented Interfaces:

Serializable, RemoteReferenceFactory, Object, IDLEntity, ServantLocator, ServantLocatorOperations, ServantManager, ServantManagerOperations

public final class POARemoteReferenceFactory
extends LocalObject
implements RemoteReferenceFactory, ServantLocator

This class implements the RemoteReferenceFactory interface for the RMI/IIOP ORB with POA (Portable Object Adapter). There is one instance of the POARemoteReferenceFactory for each EJB type. It also implements the preinvoke/postinvoke APIs in the POA's ServantLocator interface, which are called before/after every invocation (local or remote). It creates a RMI-IIOP-POA object reference (a stub) for every EJBObject and EJBHome in the EJB container.

Author:

Kenneth Saks

See Also:

Serialized Form

Method Summary

Modifier and Type	Method and Description
void	cleanupClass(Class clazz)
Remote	createHomeReference(byte[] homeKey) Create a remote reference for an EJBHome which can be used for performing remote invocations.
Remote	createRemoteReference(byte[] instanceKey) Create a remote reference for an EJBObject which can be used for performing remote invocations.
void	destroy() Destroy the factory itself.
void	destroyReference(Remote remoteRef, Remote remoteObj) Disconnect an EJBObject or EJBHome from the ORB.
int	getCSIv2PolicyType()
boolean	hasSameContainerID(Object obj)
void	postinvoke(byte[] ejbKey, POA adapter, String operation, Object cookie, Servant servant)
Servant	preinvoke(byte[] ejbKey, POA adapter, String operation, CookieHolder cookieHolder) This is the implementation of ServantLocator.preinvoke() It is called from the POA before every remote invocation.
void	setRepositoryIds(Class homeIntf, Class remoteIntf)

Methods inherited from class org.omg.CORBA.LocalObject

_create_request, _create_request, _duplicate, _get_domain_managers, _get_interface_def, _get_interface, _get_policy, _hash, _invoke, _is_a, _is_equivalent, _is_local, _non_existent, _orb, _release, _releaseReply, _request, _request, _servant_postinvoke, _servant_preinvoke, _set_policy_override, validate_connection

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.omg.CORBA.Object

_create_request, _create_request, _duplicate, _get_domain_managers, _get_interface_def, _get_policy, _hash, _is_a, _is_equivalent, _non_existent, _release, _request, _set_policy_override

Method Detail

getCSIv2PolicyType

public int getCSIv2PolicyType()

Specified by:

getCSIv2PolicyType in interface RemoteReferenceFactory

setRepositoryIds

public void setRepositoryIds(Class homeIntf,
                             Class remoteIntf)

Specified by:

setRepositoryIds in interface RemoteReferenceFactory

cleanupClass

public void cleanupClass(Class clazz)

Specified by:

cleanupClass in interface RemoteReferenceFactory

createRemoteReference

public Remote createRemoteReference(byte[] instanceKey)

Description copied from interface: RemoteReferenceFactory

Create a remote reference for an EJBObject which can be used for performing remote invocations. The key specifies the unique "object-id" of the EJBObject. This operation should not create any "tie" for the particular remote object instance. This operation should not cause the ProtocolManager to maintain any instance-specific state about the EJB instance.

Specified by:

createRemoteReference in interface RemoteReferenceFactory

Parameters:

instanceKey - a unique identifier for the EJB instance which is unique across all EJB refs created using this RemoteReferenceFactory instance.

Returns:

the protocol-specific stub of the proper derived type. It should not be necessary to narrow this stub again.

createHomeReference

public Remote createHomeReference(byte[] homeKey)

Description copied from interface: RemoteReferenceFactory

Create a remote reference for an EJBHome which can be used for performing remote invocations. The key specifies the unique "object-id" of the EJBHome. This operation should not create any "tie" for the particular remote object instance. This operation should not cause the ProtocolManager to maintain any instance-specific state about the EJB instance.

Specified by:

createHomeReference in interface RemoteReferenceFactory

Parameters:

homeKey - a unique identifier for the EJB instance which is unique across all EJB refs created using this RemoteReferenceFactory instance.

Returns:

the protocol-specific stub of the proper derived type. It should not be necessary to narrow this stub again.

destroyReference

public void destroyReference(Remote remoteRef,
                             Remote remoteObj)

Disconnect an EJBObject or EJBHome from the ORB.

Specified by:

destroyReference in interface RemoteReferenceFactory

Parameters:

remoteRef - the remote reference for the EJBObject/EJBHome

remoteObj - the servant corresponding to the remote reference.

preinvoke

public Servant preinvoke(byte[] ejbKey,
                         POA adapter,
                         String operation,
                         CookieHolder cookieHolder)
                  throws ForwardRequest

This is the implementation of ServantLocator.preinvoke() It is called from the POA before every remote invocation. Return a POA Servant (which is the RMI/IIOP Tie for EJBObject/EJBHome).

Specified by:

preinvoke in interface ServantLocatorOperations

Parameters:

ejbKey -

cookieHolder -

Throws:

ForwardRequest

postinvoke

public void postinvoke(byte[] ejbKey,
                       POA adapter,
                       String operation,
                       Object cookie,
                       Servant servant)

Specified by:

postinvoke in interface ServantLocatorOperations

destroy

public void destroy()

Description copied from interface: RemoteReferenceFactory

Destroy the factory itself. Called during shutdown / undeploy. The factory is expected to release all resources in this method.

Specified by:

destroy in interface RemoteReferenceFactory

hasSameContainerID

public boolean hasSameContainerID(Object obj)
                           throws Exception

Specified by:

hasSameContainerID in interface RemoteReferenceFactory

Throws:

Exception