Package 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 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​(org.omg.CORBA.Object ref)
                    throws Exception
        Throws:
        Exception

      • setRepositoryIds

        void setRepositoryIds​(Class homeIntf,
                      Class remoteIntf)

      • cleanupClass

        void cleanupClass​(Class clazz)

      • getCSIv2PolicyType

        int getCSIv2PolicyType()