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
All Methods Instance Methods Abstract Methods Modifier and Type Method 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(org.omg.CORBA.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/EJBHomeremoteObj
- 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(org.omg.CORBA.Object ref) throws Exception
- Throws:
Exception
-
cleanupClass
void cleanupClass(Class clazz)
-
getCSIv2PolicyType
int getCSIv2PolicyType()
-
-