com.j_spaces.core

Interface IJSpaceContainer

All Superinterfaces:

Remote

All Known Implementing Classes:

JSpaceContainerImpl, LRMIJSpaceContainer

Deprecated.

Since 8.0 - This interface is reserved for internal usage only.

@Deprecated
public interface IJSpaceContainer
extends Remote

Since:

1.0

Version:

5.1

Author:

Igor Goldenberg

See Also:

IJSpace, SpaceFinder

Method Summary

Modifier and Type	Method and Description
IJSpace	getClusteredSpace(String spaceName) Deprecated.
String	getName() Deprecated. Returns the name of this container.
IJSpace	getSpace(String spaceName) Deprecated.
String[]	getSpaceNames() Deprecated.
SpaceURL	getURL() Deprecated. Returns the SpaceURL instance which was used to initialize the space.
void	ping() Deprecated. Checks whether the container is alive and accessible.
void	shutdown() Deprecated.

Method Detail

getName

String getName()
        throws RemoteException

Deprecated.

Returns the name of this container.

Returns:

the name of this container.

Throws:

RemoteException - if a communication error occurs

getURL

SpaceURL getURL()
         throws RemoteException

Deprecated.

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.

Returns:

SpaceURL which initialized that specific space instance.

Throws:

RemoteException

ping

void ping()
   throws RemoteException

Deprecated.

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");
 }
 

Throws:

RemoteException - when container was unreachable

getSpaceNames

@Deprecated
String[] getSpaceNames()
                            throws RemoteException

Deprecated.

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

Returns:

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

Throws:

RemoteException - if a communication error occurs

getSpace

@Deprecated
IJSpace getSpace(String spaceName)
                      throws NoSuchNameException,
                             RemoteException

Deprecated.

Returns a proxy of the specified space.

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

getClusteredSpace

@Deprecated
IJSpace getClusteredSpace(String spaceName)
                               throws NoSuchNameException,
                                      RemoteException

Deprecated.

Returns a clustered proxy of the specified space.

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

shutdown

@Deprecated
void shutdown()
                   throws RemoteException

Deprecated.

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

Throws:

RemoteException - if a communication error occurs