org.openspaces.admin.space

Interface SpaceInstance

All Superinterfaces:

AdminAware, DiscoverableComponent, GridComponent, MachineAware, OperatingSystemAware, StatisticsMonitor, TransportAware, VirtualMachineAware, ZoneAware

All Known Subinterfaces:

InternalSpaceInstance

All Known Implementing Classes:

DefaultSpaceInstance

public interface SpaceInstance
extends GridComponent, StatisticsMonitor

A Space Instance is a single instance of a space running as a part of a Space. For example, when deploying a 2 partitions each with one backup topology, there will be 4 space instances running.

Author:

kimchy

Field Summary

Fields inherited from interface org.openspaces.admin.StatisticsMonitor

DEFAULT_HISTORY_SIZE, DEFAULT_MONITOR_INTERVAL

Method Summary

Modifier and Type	Method and Description
Future<?>	demote(long maxSuspendTime, TimeUnit unit) Demote a primary space instance to backup
int	getBackupId() Returns the backup id (if it is a topology with backups) of the space instance.
ClusterInfo	getClusterInfo() Returns the space cluster information.
GigaSpace	getGigaSpace() Returns the direct proxy to the actual space instance.
String	getId() Returns the Space instance Identifier
int	getInstanceId() Returns the instance id of the space (starting from 1).
SpaceMode	getMode() Returns the space mode, indicating if the space is primary or backup.
SpacePartition	getPartition() Returns the partition this instance is part of.
ReplicationStatusChangedEventManager	getReplicationStatusChanged() Allows to register for ReplicationStatusChangedEvents.
ReplicationTarget[]	getReplicationTargets() Returns the replication targets this space instance is replicating to.
SpaceInstanceRuntimeDetails	getRuntimeDetails() Returns the space runtime information.
Space	getSpace() Returns the space this instance is part of.
String	getSpaceInstanceName() Get this Space instance String representation. If the Space is part of a highly-available partition (i.e.
SpaceInstanceRemoteClassLoaderInfo	getSpaceInstanceRemoteClassLoaderInfo() Returns information about the space class loaders
SpaceModeChangedEventManager	getSpaceModeChanged() Allows to register for SpaceModeChangedEvents.
SpaceSuspendTypeChangedEventManager	getSpaceSuspendTypeChanged() Allows to register for SpaceSuspendTypeChangedEvents.
SpaceURL	getSpaceUrl()
SpaceInstanceStatistics	getStatistics() Returns the space instance statistics.
SpaceInstanceStatisticsChangedEventManager	getStatisticsChanged() Allows to register for SpaceInstanceStatisticsChangedEvents.
SuspendInfo	getSuspendInfo()
boolean	waitForMode(SpaceMode requiredMode, long timeout, TimeUnit timeUnit) Waits for the space instance to move to the provided space mode.

Methods inherited from interface org.openspaces.admin.GridComponent

getUid

Methods inherited from interface org.openspaces.admin.DiscoverableComponent

isDiscovered

Methods inherited from interface org.openspaces.admin.AdminAware

getAdmin

Methods inherited from interface org.openspaces.admin.machine.MachineAware

getMachine

Methods inherited from interface org.openspaces.admin.transport.TransportAware

getTransport

Methods inherited from interface org.openspaces.admin.os.OperatingSystemAware

getOperatingSystem

Methods inherited from interface org.openspaces.admin.vm.VirtualMachineAware

getVirtualMachine

Methods inherited from interface org.openspaces.admin.zone.ZoneAware

getZones

Methods inherited from interface org.openspaces.admin.StatisticsMonitor

isMonitoring, setStatisticsHistorySize, setStatisticsInterval, startStatisticsMonitor, stopStatisticsMonitor

Method Detail

getId

String getId()

Returns the Space instance Identifier

Since:

12.1

getSpaceInstanceName

String getSpaceInstanceName()

Get this Space instance String representation.
If the Space is part of a highly-available partition (i.e. with backups), returns: {Space name}.{instance/partition id} [backup id] - for example, MySpace.3 [1]
Otherwise, when there are no backups (i.e. only partitioned), returns: {Space name} [instance/partition id] - for example, MySpace [3]

Returns:

this Space instance String representation.

Since:

8.0.4

getClusterInfo

ClusterInfo getClusterInfo()

Returns the space cluster information.

Since:

12.1

getInstanceId

int getInstanceId()

Returns the instance id of the space (starting from 1).

getBackupId

int getBackupId()

Returns the backup id (if it is a topology with backups) of the space instance.

getMode

SpaceMode getMode()

Returns the space mode, indicating if the space is primary or backup.

getSpaceUrl

SpaceURL getSpaceUrl()

waitForMode

boolean waitForMode(SpaceMode requiredMode,
                    long timeout,
                    TimeUnit timeUnit)

Waits for the space instance to move to the provided space mode. Returns true if the mode was changed to the required one withing the timeout, or false otherwise.

getGigaSpace

GigaSpace getGigaSpace()

Returns the direct proxy to the actual space instance.

getStatistics

SpaceInstanceStatistics getStatistics()

Returns the space instance statistics.

getRuntimeDetails

SpaceInstanceRuntimeDetails getRuntimeDetails()

Returns the space runtime information.

getSpace

Space getSpace()

Returns the space this instance is part of.

getPartition

SpacePartition getPartition()

Returns the partition this instance is part of.

getReplicationTargets

ReplicationTarget[] getReplicationTargets()

Returns the replication targets this space instance is replicating to.

getSpaceModeChanged

SpaceModeChangedEventManager getSpaceModeChanged()

Allows to register for SpaceModeChangedEvents.

getSpaceSuspendTypeChanged

SpaceSuspendTypeChangedEventManager getSpaceSuspendTypeChanged()

Allows to register for SpaceSuspendTypeChangedEvents.

getReplicationStatusChanged

ReplicationStatusChangedEventManager getReplicationStatusChanged()

Allows to register for ReplicationStatusChangedEvents.

getStatisticsChanged

SpaceInstanceStatisticsChangedEventManager getStatisticsChanged()

Allows to register for SpaceInstanceStatisticsChangedEvents.

Note, monitoring must be started using StatisticsMonitor.startStatisticsMonitor() for events to occur.

getSpaceInstanceRemoteClassLoaderInfo

SpaceInstanceRemoteClassLoaderInfo getSpaceInstanceRemoteClassLoaderInfo()

Returns information about the space class loaders

demote

Future<?> demote(long maxSuspendTime,
                 TimeUnit unit)

Demote a primary space instance to backup

getSuspendInfo

SuspendInfo getSuspendInfo()