com.gigaspaces.cluster.activeelection

Class SpaceComponentManager

java.lang.Object

com.gigaspaces.cluster.activeelection.SpaceComponentManager

All Implemented Interfaces:

ISpaceModeListener, Remote, EventListener

public class SpaceComponentManager
extends Object
implements ISpaceModeListener

SpaceComponentManager handles SpaceInternal components.
The manager handles all space mode transitions and changes the components state according to the space state.

Space states: -------------------------------------------------------------

• NONE - the initial state of the space before election.
  
• PRIMARY - the state of the space after is was selected as primary.
  
• BACKUP - the state of the space after it was selected as backup.
  

Space components types:
--------------------------------------------------------------
backup components - components that can run on backup spaces.
primary only - components that can run only on primary spaces.

The following state transitions are handled:
--------------------------------------------------
NONE-->PRIMARY - space becomes primary after the first election. All components are started.

NONE-->BACKUP - space becomes backup after the first election. Only the backup components are started.

BACKUP-->PRIMARY - space becomes primary after previously being backup. Only the primary-only components are started, since backup components are already up.

PRIMARY-->BACKUP - in case of a "split-brain" where two spaces are primary at the same time, one of them returns to backup. In this case all the space components are restarted.

Since:

6.0

Version:

1.0

Author:

anna

Constructor Summary

Constructors

Constructor and Description
SpaceComponentManager(SpaceImpl space) Constructor.

Method Summary

Modifier and Type	Method and Description
void	afterMovingToBackup() Called after space becomes backup.
void	afterSpaceModeChange(SpaceMode newMode) Called right after the space mode changes.
void	beforeMovingToBackup() Called before space becomes backup.
void	beforeSpaceModeChange(SpaceMode newMode) Called right before the space mode changes. Implementors usually use it to allow specific service initializations.
void	clear()
LinkedList<ISpaceComponentsHandler>	getComponentsHandlers()
SpaceImpl	getSpace()
SpaceMode	getSpaceMode()
void	init() Initialize the component manager with space components.
void	initComponents() Initialize all space components
void	restartSpaceComponents() Restart space components.
void	setComponentsHandlers(LinkedList<ISpaceComponentsHandler> componentsHandlers)
void	setSpace(SpaceImpl space)
void	setSpaceMode(SpaceMode spaceMode)
void	startComponents() Start all space components

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

SpaceComponentManager

public SpaceComponentManager(SpaceImpl space)
                      throws SpaceComponentsInitializeException

Constructor.

Throws:

SpaceComponentsInitializeException

Method Detail

init

public void init()
          throws SpaceComponentsInitializeException

Initialize the component manager with space components. Initialize any component that can be run during recovery. Only components that can run on backup are initialized, Primary-only components are initialized later, since they can't run during recovery.

Throws:

SpaceComponentsInitializeException

beforeSpaceModeChange

public void beforeSpaceModeChange(SpaceMode newMode)

Description copied from interface: ISpaceModeListener

Called right before the space mode changes.
Implementors usually use it to allow specific service initializations.

Specified by:

beforeSpaceModeChange in interface ISpaceModeListener

Parameters:

newMode - the new mode change before it's published.

afterSpaceModeChange

public void afterSpaceModeChange(SpaceMode newMode)

Description copied from interface: ISpaceModeListener

Called right after the space mode changes.
Implementors usually use it to invoke any needed services.

Specified by:

afterSpaceModeChange in interface ISpaceModeListener

Parameters:

newMode - the new mode change after it was published.

afterMovingToBackup

public void afterMovingToBackup()

Called after space becomes backup. Any space component that can run on backup is started. (active-when-backup=true)

beforeMovingToBackup

public void beforeMovingToBackup()
                          throws SpaceComponentsInitializeException

Called before space becomes backup. Any space component that can run on backup is initialized. (active-when-backup=true)

Throws:

SpaceComponentsInitializeException

initComponents

public void initComponents()
                    throws SpaceComponentsInitializeException

Initialize all space components

Throws:

SpaceComponentsInitializeException

startComponents

public void startComponents()

Start all space components

restartSpaceComponents

public void restartSpaceComponents()
                            throws SpaceComponentsInitializeException

Restart space components. Space state doesn't change

Throws:

SpaceComponentsInitializeException

getComponentsHandlers

public LinkedList<ISpaceComponentsHandler> getComponentsHandlers()

Returns:

Returns the componentsHandlers.

setComponentsHandlers

public void setComponentsHandlers(LinkedList<ISpaceComponentsHandler> componentsHandlers)

Parameters:

componentsHandlers - The componentsHandlers to set.

getSpace

public SpaceImpl getSpace()

Returns:

Returns the space.

setSpace

public void setSpace(SpaceImpl space)

Parameters:

space - The space to set.

getSpaceMode

public SpaceMode getSpaceMode()

Returns:

Returns the spaceMode.

setSpaceMode

public void setSpaceMode(SpaceMode spaceMode)

Parameters:

spaceMode - The spaceMode to set.

clear

public void clear()