FileDocCategorySizeDatePackage
RemoteReferenceFactory.javaAPI DocGlassfish v2 API4810Fri May 04 22:33:16 BST 2007com.sun.enterprise

RemoteReferenceFactory

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

Fields Summary
Constructors Summary
Methods Summary
public voidcleanupClass(java.lang.Class clazz)

public javax.ejb.EJBHomecreateHomeReference(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.

param
instanceKey a unique identifier for the EJB instance which is unique across all EJB refs created using this RemoteReferenceFactory instance.
return
the protocol-specific stub of the proper derived type. It should not be necessary to narrow this stub again.

public java.rmi.RemotecreateRemoteReference(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.

param
instanceKey a unique identifier for the EJB instance which is unique across all EJB refs created using this RemoteReferenceFactory instance.
return
the protocol-specific stub of the proper derived type. It should not be necessary to narrow this stub again.

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

public voiddestroyReference(java.rmi.Remote remoteRef, java.rmi.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.

param
remoteRef the remote reference for the EJBObject/EJBHome
param
remoteObj the servant corresponding to the remote reference.

public booleanhasSameContainerID(org.omg.CORBA.Object ref)

public voidsetRepositoryIds(java.lang.Class homeIntf, java.lang.Class remoteIntf)