org.glassfish.enterprise.iiop.api

Interface RemoteReferenceFactory

All Known Implementing Classes:

POARemoteReferenceFactory

public interface RemoteReferenceFactory

The RemoteReferenceFactory interface provides methods to create and destroy remote EJB references. Instances of the RemoteReferenceFactory are obtained from the ProtocolManager.

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) Destroy an EJBObject or EJBHome remote ref so that it can no longer be used for remote invocations.
int	getCSIv2PolicyType()
boolean	hasSameContainerID(Object ref)
void	setRepositoryIds(Class homeIntf, Class remoteIntf)

Method Detail

createRemoteReference

Remote createRemoteReference(byte[] instanceKey)

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.

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

Remote createHomeReference(byte[] homeKey)

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.

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

void destroyReference(Remote remoteRef,
                      Remote remoteObj)

Destroy an EJBObject or EJBHome remote ref so that it can no longer be used for remote invocations. This operation should destroy any state such as "tie" objects maintained by the ProtocolManager for the EJBObject or EJBHome.

Parameters:

remoteRef - the remote reference for the EJBObject/EJBHome

remoteObj - the servant corresponding to the remote reference.

destroy

void destroy()

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

hasSameContainerID

boolean hasSameContainerID(Object ref)
                    throws Exception

Throws:

Exception

setRepositoryIds

void setRepositoryIds(Class homeIntf,
                      Class remoteIntf)

cleanupClass

void cleanupClass(Class clazz)

getCSIv2PolicyType

int getCSIv2PolicyType()