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
  • Method Details

    • 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

      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()
    • isSecured

      boolean isSecured()