GigaSpaces XAP 7.0 API

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)

Version:
1.0
Author:
Igor Goldenberg

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.
 com.gigaspaces.config.lrmi.ITransportConfig getTransportConfig()
          Returns the default transport config associated with this stub handler
 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:
obj - the object to disable stub for
force - should force unxport
Throws:
RemoteException - Failed to unexport object.

getTransportConfig

com.gigaspaces.config.lrmi.ITransportConfig getTransportConfig()
Returns the default transport config associated with this stub handler

Returns:
default transport config associated with this stub handler

GigaSpaces XAP 7.0 API

Copyright © GigaSpaces.