org.waarp.common.state

Class MachineState<E extends Enum<E>>

java.lang.Object

org.waarp.common.state.MachineState<E>

Type Parameters:

E -

public class MachineState<E extends Enum<E>>
extends Object

This is the base class for the basic support of Finite State Machine in GoldenGate. One need to implement an Enum class to use with it.

Note: the type EnumSet< ? > is in fact of type EnumSet< EnumState >

Constructor Summary

Constructors

Constructor and Description
MachineState(E initialState) Initialize with an initialState but no association (Machine State is empty)
MachineState(E initialState, ConcurrentMap<E,EnumSet<E>> map) Initialize with an initialState

Method Summary

Modifier and Type	Method and Description
EnumSet<E>	addNewAssociation(E state, EnumSet<E> set) Add a new association from one state to a set of acceptable following states (can replace an existing association)
EnumSet<E>	addNewAssociation(Transition<E> elt) Add a new association from one state to a set of acceptable following states (can replace an existing association)
E	getCurrent() Return the current application state.
void	release() Release the Machine State
EnumSet<E>	removeAssociation(E state) Remove an association from one state to any acceptable following states
E	setCurrent(E desiredState) Sets the current application state.
E	setDryCurrent(E desiredState) Sets the current application state, but no exception if not compatible.

Methods inherited from class java.lang.Object

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

Constructor Detail

MachineState

public MachineState(E initialState,
                    ConcurrentMap<E,EnumSet<E>> map)

Initialize with an initialState

Parameters:

initialState - initial MachineState

map - the association of state and set of acceptable following states

MachineState

public MachineState(E initialState)

Initialize with an initialState but no association (Machine State is empty)

Parameters:

initialState - initial MachineState

Method Detail

addNewAssociation

public final EnumSet<E> addNewAssociation(E state,
                                          EnumSet<E> set)

Add a new association from one state to a set of acceptable following states (can replace an existing association)

Parameters:

state -

set - the new association

Returns:

the previous association if any

addNewAssociation

public final EnumSet<E> addNewAssociation(Transition<E> elt)

Add a new association from one state to a set of acceptable following states (can replace an existing association)

Parameters:

elt -

Returns:

the previous association if any

removeAssociation

public final EnumSet<E> removeAssociation(E state)

Remove an association from one state to any acceptable following states

Parameters:

state - the state to remove any acceptable following states

Returns:

the previous association if any

getCurrent

public final E getCurrent()

Return the current application state.

Returns:

the current State

setCurrent

public final E setCurrent(E desiredState)
                   throws IllegalFiniteStateException

Sets the current application state.

Parameters:

desiredState -

Returns:

the requested state, if it was reachable

Throws:

IllegalFiniteStateException - if the state is not allowed

setDryCurrent

public final E setDryCurrent(E desiredState)

Sets the current application state, but no exception if not compatible.

Parameters:

desiredState -

Returns:

the requested state, even if it was not reachable

release

public final void release()

Release the Machine State