Class StateMachine

java.lang.Object

org.apache.mina.statemachine.StateMachine

public class StateMachine
extends Object

Represents a complete state machine. Contains a collection of State objects connected by Transitions. Normally you wouldn't create instances of this class directly but rather use the State annotation to define your states and then let StateMachineFactory create a StateMachine for you.

Field Summary

Fields

Modifier and Type	Field	Description
private static final String	CALL_STACK
private final ThreadLocal<LinkedList<Event>>	eventQueueThreadLocal
private static final org.slf4j.Logger	LOGGER
private final ThreadLocal<Boolean>	processingThreadLocal
private final State	startState
private final Map<String,State>	states

Constructor Summary

Constructors

Constructor	Description
StateMachine(Collection<State> states, String startStateId)	Creates a new instance using the specified States and start state.
StateMachine(State[] states, String startStateId)	Creates a new instance using the specified States and start state.

Method Summary

Modifier and Type	Method	Description
(package private) void	executeOnEntries(StateContext context, State state)
(package private) void	executeOnExits(StateContext context, State state)
private Deque<State>	getCallStack(StateContext context)
State	getState(String id)	Returns the State with the specified id.
Collection<State>	getStates()
void	handle(Event event)	Processes the specified Event through this StateMachine.
private void	handle(State state, Event event)
private void	processEvents(LinkedList<Event> eventQueue)
private void	setCurrentState(StateContext context, State newState)

Methods inherited from class Object

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

Field Details

LOGGER

private static final org.slf4j.Logger LOGGER

CALL_STACK

private static final String CALL_STACK

startState

private final State startState

states

private final Map<String,State> states

processingThreadLocal

private final ThreadLocal<Boolean> processingThreadLocal

eventQueueThreadLocal

private final ThreadLocal<LinkedList<Event>> eventQueueThreadLocal

Constructor Details

StateMachine

public StateMachine(State[] states,
 String startStateId)

Creates a new instance using the specified States and start state.

Parameters:

states - the States.

startStateId - the id of the start State.

StateMachine

public StateMachine(Collection<State> states,
 String startStateId)

Creates a new instance using the specified States and start state.

Parameters:

states - the States.

startStateId - the id of the start State.

Method Details

getState

public State getState(String id)

Returns the State with the specified id.

Parameters:

id - the id of the State to return.

Returns:

the State

Throws:

NoSuchStateException - if no matching State could be found.

getStates

public Collection<State> getStates()

Returns:

an unmodifiable Collection of all States used by this StateMachine.

handle

public void handle(Event event)

Processes the specified Event through this StateMachine. Normally you wouldn't call this directly but rather use StateMachineProxyBuilder to create a proxy for an interface of your choice. Any method calls on the proxy will be translated into Event objects and then fed to the StateMachine by the proxy using this method.

Parameters:

event - the Event to be handled.

processEvents

private void processEvents(LinkedList<Event> eventQueue)

handle

private void handle(State state,
 Event event)

getCallStack

private Deque<State> getCallStack(StateContext context)

setCurrentState

private void setCurrentState(StateContext context,
 State newState)

executeOnExits

void executeOnExits(StateContext context,
 State state)

executeOnEntries

void executeOnEntries(StateContext context,
 State state)