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.