com.j_spaces.core
Interface IStubHandler

All Superinterfaces:
Serializable

public interface IStubHandler
extends Serializable

A filter that contains functions to control the life cycle of a space related stub. It can be used to implement SSL security in (some of the) space stubs or create a stub that implements a different protocol from the com.j_spaces.core.StubHandlerImpl which is the default GigaSpaces implementation (non-secure RMI)


Field Summary
static String NIO_PROTOCOL
          NIO protocol constant
static String RMI_PROTOCOL
          RMI protocol constant
 
Method Summary
 Remote exportObject(Remote obj)
          Exports the remote object to make it available to receive incoming calls.
 void init(String spaceName, String containerName)
           
 void unexportObject(Remote obj, boolean force)
          Removes the remote object, obj, from the StubHandler runtime.
 

Field Detail

RMI_PROTOCOL

static final String RMI_PROTOCOL
RMI protocol constant

See Also:
Constant Field Values

NIO_PROTOCOL

static final String NIO_PROTOCOL
NIO protocol constant

See Also:
Constant Field Values
Method Detail

init

void init(String spaceName,
          String containerName)
Parameters:
spaceName - space name
containerName - container name

exportObject

Remote exportObject(Remote obj)
                    throws RemoteException
Exports the remote object to make it available to receive incoming calls.

Parameters:
obj - the remote object to be exported
Returns:
remote object stub
Throws:
RemoteException - if export fails

unexportObject

void unexportObject(Remote obj,
                    boolean force)
                    throws RemoteException
Removes the remote object, obj, from the StubHandler runtime. If successful, the object can no longer accept incoming RMI calls.

Parameters:
subject - the object to disable stub for
Throws:
RemoteException - Failed to unexport object.