org.glassfish.enterprise.iiop.api

Interface ProtocolManager

All Known Implementing Classes:

POAProtocolMgr

@Contract
public interface ProtocolManager

The ProtocolManager interface specifies the functionality of the remote communication layer, which provides the support for distribution described in Chapter 13 of the EJB spec. Possible implementations of the ProtocolManager include RMI/IIOP, RMI/JRMP, RMI/DCOM, RMI/HTTP ....

Author:

Vivek Nagar

Method Summary

Modifier and Type	Method and Description
void	connectObject(Remote remoteObj) Connect the RMI object to the protocol.
EjbDescriptor	getEjbDescriptor(byte[] ejbKey)
byte[]	getObjectID(Object obj)
RemoteReferenceFactory	getRemoteReferenceFactory(EjbContainerFacade container, boolean remoteHomeView, String id) Return a factory that can be used to create/destroy remote references for a particular EJB type.
void	initialize(ORB o)
void	initializeNaming()
void	initializePOAs()
void	initializeRemoteNaming(Remote remoteNamingProvider)
boolean	isIdentical(Remote obj1, Remote obj2) Return true if the two object references refer to the same remote object.
boolean	isLocal(Object obj)
boolean	isStub(Object obj) True if object is a corba stub
Throwable	mapException(Throwable exception) Map the RMI exception to a protocol-specific (e.g.
void	validateTargetObjectInterfaces(Remote targetObj) Check that all Remote interfaces implemented by target object conform to the rules for valid RMI-IIOP interfaces.

Method Detail

initialize

void initialize(ORB o)

initializePOAs

void initializePOAs()
             throws Exception

Throws:

Exception

initializeNaming

void initializeNaming()
               throws Exception

Throws:

Exception

initializeRemoteNaming

void initializeRemoteNaming(Remote remoteNamingProvider)
                     throws Exception

Throws:

Exception

getRemoteReferenceFactory

RemoteReferenceFactory getRemoteReferenceFactory(EjbContainerFacade container,
                                                 boolean remoteHomeView,
                                                 String id)

Return a factory that can be used to create/destroy remote references for a particular EJB type.

isIdentical

boolean isIdentical(Remote obj1,
                    Remote obj2)

Return true if the two object references refer to the same remote object.

validateTargetObjectInterfaces

void validateTargetObjectInterfaces(Remote targetObj)

Check that all Remote interfaces implemented by target object conform to the rules for valid RMI-IIOP interfaces. Throws runtime exception if validation fails.

mapException

Throwable mapException(Throwable exception)

Map the RMI exception to a protocol-specific (e.g. CORBA) exception

isStub

boolean isStub(Object obj)

True if object is a corba stub

isLocal

boolean isLocal(Object obj)

getObjectID

byte[] getObjectID(Object obj)

connectObject

void connectObject(Remote remoteObj)
            throws RemoteException

Connect the RMI object to the protocol.

Throws:

RemoteException

getEjbDescriptor

EjbDescriptor getEjbDescriptor(byte[] ejbKey)