Package com.j_spaces.core

Class LRMIJSpaceContainer

java.lang.Object

com.gigaspaces.lrmi.RemoteStub<IJSpaceContainer>

com.j_spaces.core.LRMIJSpaceContainer

All Implemented Interfaces:

ILRMIProxy, SmartExternalizable, IJSpaceContainerAdmin, IJSpaceContainer, Externalizable, Serializable, Remote

public class LRMIJSpaceContainer
extends RemoteStub<IJSpaceContainer>
implements IJSpaceContainer, IJSpaceContainerAdmin

LRMI Stub implementation of IJSpaceContainer, IJSpaceContainerAdmin, LifeCycle,Service interface.

Since:

7.0

Author:

eitany

See Also:

• Serialized Form

Field Summary

Fields

Modifier and Type	Field	Description
static final ThreadLocal<Boolean>	isEmbeddedShutdownInvocation

Constructor Summary

Constructors

Constructor	Description
LRMIJSpaceContainer()
LRMIJSpaceContainer(IJSpaceContainer directObjRef, IJSpaceContainer dynamicProxy, String name)

Method Summary

Modifier and Type	Method	Description
IJSpace	getClusteredSpace(String spaceName)	Returns a clustered proxy of the specified space.
ContainerConfig	getConfig()	Get container configuration.
String	getName()	Returns the name of this container.
String	getRuntimeConfigReport()	Returns runtime configuration report: dump of the overall system configurations (spaces, container, cluster), system env, sys properties.
IJSpace	getSpace(String spaceName)	Returns a proxy of the specified space.
String[]	getSpaceNames()	Returns the names of the spaces that belong to this container.
SpaceURL	getURL()	Returns the SpaceURL instance which was used to initialize the space.
void	ping()	Checks whether the container is alive and accessible.
void	setConfig(ContainerConfig config)	Set new container configuration.
void	shutdown()	Shuts down this container.

Methods inherited from class com.gigaspaces.lrmi.RemoteStub

closeProxy, disable, enable, equals, getConnectionUrl, getDynamicProxy, getGeneratedTraffic, getProxy, getReceivedTraffic, getRemoteHostAddress, getRemoteHostName, getRemoteNetworkAddress, getRemoteProcessId, getServicePlatformLogicalVersion, getStubId, hashCode, init, isClosed, isCollocated, isCollocatedStub, isDirect, isRemote, isStub, overrideMethodsMetadata, readExternal, toString, writeExternal

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface com.gigaspaces.serialization.SmartExternalizable

enabledSmartExternalizableWithReference

Field Details

isEmbeddedShutdownInvocation

public static final ThreadLocal<Boolean> isEmbeddedShutdownInvocation

Constructor Details

LRMIJSpaceContainer

public LRMIJSpaceContainer()

LRMIJSpaceContainer

public LRMIJSpaceContainer(IJSpaceContainer directObjRef,
 IJSpaceContainer dynamicProxy,
 String name)

Method Details

getClusteredSpace

public IJSpace getClusteredSpace(String spaceName)
                          throws NoSuchNameException,
RemoteException

Description copied from interface: IJSpaceContainer

Returns a clustered proxy of the specified space.

Specified by:

getClusteredSpace in interface IJSpaceContainer

Parameters:

spaceName - the name of the space.

Returns:

IJSpace clustered space proxy.

Throws:

NoSuchNameException - if the specified space does not exist in this container.

RemoteException - if a communication error occurs

getName

public String getName()
               throws RemoteException

Description copied from interface: IJSpaceContainer

Returns the name of this container.

Specified by:

getName in interface IJSpaceContainer

Specified by:

getName in interface IJSpaceContainerAdmin

Returns:

the name of this container.

Throws:

RemoteException - if a communication error occurs

getSpace

public IJSpace getSpace(String spaceName)
                 throws NoSuchNameException,
RemoteException

Description copied from interface: IJSpaceContainer

Returns a proxy of the specified space.

Specified by:

getSpace in interface IJSpaceContainer

Parameters:

spaceName - the name of the space.

Returns:

IJSpace space proxy.

Throws:

NoSuchNameException - if the specified space does not exist in this container.

RemoteException - if a communication error occurs

getSpaceNames

public String[] getSpaceNames()
                       throws RemoteException

Description copied from interface: IJSpaceContainer

Returns the names of the spaces that belong to this container.

Specified by:

getSpaceNames in interface IJSpaceContainer

Returns:

String[] the names of the spaces that belong to this container.

Throws:

RemoteException - if a communication error occurs

getURL

public SpaceURL getURL()
                throws RemoteException

Description copied from interface: IJSpaceContainer

Returns the SpaceURL instance which was used to initialize the space.

Notice: The SpaceURL object contains information on the space and container configuration/setup such as space url used, space/container/cluster schema used and other attributes.

The IJSpace keeps also its reference of the SpaceURL which launched the container.

Specified by:

getURL in interface IJSpaceContainer

Returns:

SpaceURL which initialized that specific space instance.

Throws:

RemoteException

ping

public void ping()
          throws RemoteException

Description copied from interface: IJSpaceContainer

Checks whether the container is alive and accessible.

 IJSpaceContainer aContainer = (IJSpaceContainer)SpaceFinder.find("jini://lookup-host/container-name");
 try{
    aContainer.ping();
    System.out.println("Container alive");
 }
 catch (java.rmi.RemoteException re) {
    System.out.println("Container unreachable");
 }
 

Specified by:

ping in interface IJSpaceContainer

Throws:

RemoteException - when container was unreachable

shutdown

public void shutdown()
              throws RemoteException

Description copied from interface: IJSpaceContainer

Shuts down this container. This also involves unregistering all registered spaces from Lookup services and closing connections to storage adapters.

Specified by:

shutdown in interface IJSpaceContainer

Throws:

RemoteException - if a communication error occurs

getConfig

public ContainerConfig getConfig()
                          throws RemoteException

Description copied from interface: IJSpaceContainerAdmin

Get container configuration.

Specified by:

getConfig in interface IJSpaceContainerAdmin

Returns:

ContainerConfig The container config structure.

Throws:

RemoteException - Failed to retrieve container configuration.

getRuntimeConfigReport

public String getRuntimeConfigReport()
                              throws RemoteException

Description copied from interface: IJSpaceContainerAdmin

Returns runtime configuration report: dump of the overall system configurations (spaces, container, cluster), system env, sys properties.

Specified by:

getRuntimeConfigReport in interface IJSpaceContainerAdmin

Returns:

runtime configuration report

Throws:

RemoteException - Failed to get runtime configuration report.

setConfig

public void setConfig(ContainerConfig config)
               throws RemoteException

Description copied from interface: IJSpaceContainerAdmin

Set new container configuration.

Specified by:

setConfig in interface IJSpaceContainerAdmin

Parameters:

config - The container config structure.

Throws:

RemoteException - Failed to set new container configuration.