org.squirrelframework.foundation.fsm

Interface StateMachineBuilder<T extends StateMachine<T,S,E,C>,S,E,C>

Type Parameters:

T - The type of implemented state machine

S - The type of implemented state

E - The type of implemented event

C - The type of implemented context

All Known Subinterfaces:

UntypedStateMachineBuilder

All Known Implementing Classes:

StateMachineBuilderImpl

public interface StateMachineBuilder<T extends StateMachine<T,S,E,C>,S,E,C>

State machine builder API.

Author:

Henry.He

Method Summary

Methods

Modifier and Type	Method and Description
MutableState<T,S,E,C>	defineFinalState(S stateId) Define a final state in state machine model
void	defineFinishEvent(E finishEvent) Define event for parallel transition finished
MutableState<T,S,E,C>	defineLinkedState(S stateId, StateMachineBuilder<? extends StateMachine<?,S,E,C>,S,E,C> linkedStateMachineBuilder, S initialLinkedState, Object... extraParams) Define a linked state
void	defineNoInitSequentialStatesOn(S parentStateId, HistoryType historyType, S... childStateIds) Define sequential child states on parent state without initial state
void	defineNoInitSequentialStatesOn(S parentStateId, S... childStateIds) Define sequential child states on parent state without initial state
void	defineParallelStatesOn(S parentStateId, S... childStateIds) Define sequential child states on parent state.
void	defineSequentialStatesOn(S parentStateId, HistoryType historyType, S... childStateIds) Define sequential child states on parent state
void	defineSequentialStatesOn(S parentStateId, S... childStateIds) Define sequential child states whose hierarchy type is default set to NONE on parent state
void	defineStartEvent(E startEvent) Define event for state machine started
MutableState<T,S,E,C>	defineState(S stateId) Define a new state in state machine model
void	defineTerminateEvent(E terminateEvent) Define event for state machine terminated
MutableState<T,S,E,C>	defineTimedState(S stateId, long initialDelay, long timeInterval, E autoEvent, C autoContext) Define a timed state
ExternalTransitionBuilder<T,S,E,C>	externalTransition() Start to build external transition
ExternalTransitionBuilder<T,S,E,C>	externalTransition(int priority) Create external transition builder with priority
MultiTransitionBuilder<T,S,E,C>	externalTransitions() Create multiple external transitions builder with default priority
MultiTransitionBuilder<T,S,E,C>	externalTransitions(int priority) Create multiple external transitions builder with priority
InternalTransitionBuilder<T,S,E,C>	internalTransition() Start to build internal transition
InternalTransitionBuilder<T,S,E,C>	internalTransition(int priority) Create internal transition builder with priority
LocalTransitionBuilder<T,S,E,C>	localTransition() Start to build local transition
LocalTransitionBuilder<T,S,E,C>	localTransition(int priority) Create local transition builder with priority
MultiTransitionBuilder<T,S,E,C>	localTransitions() Create multiple local transitions builder with default priority
MultiTransitionBuilder<T,S,E,C>	localTransitions(int priority) Create multiple local transitions builder with priority
T	newStateMachine(S initialStateId) Create a new state machine instance
T	newStateMachine(S initialStateId, Object... extraParams) Create new state machine instance according to state machine definition
T	newStateMachine(S initialStateId, StateMachineConfiguration configuration, Object... extraParams) Create new state machine instance according to state machine definition
EntryExitActionBuilder<T,S,E,C>	onEntry(S stateId) Define on entry actions for state
EntryExitActionBuilder<T,S,E,C>	onExit(S stateId) Define on exit actions for state
void	setStateMachineConfiguration(StateMachineConfiguration configure) Set default state machine configuration for state machine instance created by this builder
DeferBoundActionBuilder<T,S,E,C>	transit() Create defer bound action builder
ExternalTransitionBuilder<T,S,E,C>	transition() Start to build external transition, same as externalTransition
ExternalTransitionBuilder<T,S,E,C>	transition(int priority) Same as externalTransition
MultiTransitionBuilder<T,S,E,C>	transitions() The same as externalTransitions
MultiTransitionBuilder<T,S,E,C>	transitions(int priority) the same as externalTransitions

Method Detail

externalTransition

ExternalTransitionBuilder<T,S,E,C> externalTransition()

Start to build external transition

Returns:

External transition builder

externalTransitions

MultiTransitionBuilder<T,S,E,C> externalTransitions()

Create multiple external transitions builder with default priority

Returns:

multiple external transitions builder

transition

ExternalTransitionBuilder<T,S,E,C> transition()

Start to build external transition, same as externalTransition

Returns:

External transition builder

transitions

MultiTransitionBuilder<T,S,E,C> transitions()

The same as externalTransitions

Returns:

multiple external transitions builder

transit

DeferBoundActionBuilder<T,S,E,C> transit()

Create defer bound action builder

Returns:

defer bound action builder

localTransition

LocalTransitionBuilder<T,S,E,C> localTransition()

Start to build local transition

Returns:

Local transition builder

localTransitions

MultiTransitionBuilder<T,S,E,C> localTransitions()

Create multiple local transitions builder with default priority

Returns:

multiple local transitions builder

internalTransition

InternalTransitionBuilder<T,S,E,C> internalTransition()

Start to build internal transition

Returns:

Internal transition builder

externalTransition

ExternalTransitionBuilder<T,S,E,C> externalTransition(int priority)

Create external transition builder with priority

Parameters:

priority - external transition priority

Returns:

external transition builder with priority

externalTransitions

MultiTransitionBuilder<T,S,E,C> externalTransitions(int priority)

Create multiple external transitions builder with priority

Parameters:

priority - external transitions priority

Returns:

multiple external transitions builder

transition

ExternalTransitionBuilder<T,S,E,C> transition(int priority)

Same as externalTransition

Parameters:

priority - transition priority

Returns:

External transition builder

transitions

MultiTransitionBuilder<T,S,E,C> transitions(int priority)

the same as externalTransitions

Parameters:

priority - external transitions priority

Returns:

multiple external transitions builder

localTransition

LocalTransitionBuilder<T,S,E,C> localTransition(int priority)

Create local transition builder with priority

Parameters:

priority - local transition priority

Returns:

local transition builder

localTransitions

MultiTransitionBuilder<T,S,E,C> localTransitions(int priority)

Create multiple local transitions builder with priority

Parameters:

priority - local transition priority

Returns:

local transition builder

internalTransition

InternalTransitionBuilder<T,S,E,C> internalTransition(int priority)

Create internal transition builder with priority

Parameters:

priority - internal transition priority

Returns:

internal transition

defineState

MutableState<T,S,E,C> defineState(S stateId)

Define a new state in state machine model

Parameters:

stateId - id of new state

Returns:

defined new mutable state

defineFinalState

MutableState<T,S,E,C> defineFinalState(S stateId)

Define a final state in state machine model

Parameters:

stateId - id of final state

Returns:

defined final state

defineLinkedState

MutableState<T,S,E,C> defineLinkedState(S stateId,
                                      StateMachineBuilder<? extends StateMachine<?,S,E,C>,S,E,C> linkedStateMachineBuilder,
                                      S initialLinkedState,
                                      Object... extraParams)

Define a linked state

Parameters:

stateId - id of linked state

linkedStateMachineBuilder - linked state machine builder

initialLinkedState - initial linked state

extraParams - additional parameters used to create linked state machine

Returns:

linked state

defineTimedState

MutableState<T,S,E,C> defineTimedState(S stateId,
                                     long initialDelay,
                                     long timeInterval,
                                     E autoEvent,
                                     C autoContext)

Define a timed state

Parameters:

stateId - state id

initialDelay - initial delay ms

timeInterval - time period if null not repeat

autoEvent -

autoContext -

Returns:

timed state

defineSequentialStatesOn

void defineSequentialStatesOn(S parentStateId,
                            S... childStateIds)

Define sequential child states whose hierarchy type is default set to NONE on parent state

Parameters:

parentStateId - id of parent state

childStateIds - child states id of parent state. The first child state will be used as initial child state of parent state.

defineSequentialStatesOn

void defineSequentialStatesOn(S parentStateId,
                            HistoryType historyType,
                            S... childStateIds)

Define sequential child states on parent state

Parameters:

parentStateId - id of parent state

historyType - history type of parent state

childStateIds - child states id of parent state. The first child state will be used as initial child state of parent state.

defineNoInitSequentialStatesOn

void defineNoInitSequentialStatesOn(S parentStateId,
                                  S... childStateIds)

Define sequential child states on parent state without initial state

Parameters:

parentStateId - id of parent state

childStateIds - child states id of parent state

defineNoInitSequentialStatesOn

void defineNoInitSequentialStatesOn(S parentStateId,
                                  HistoryType historyType,
                                  S... childStateIds)

Define sequential child states on parent state without initial state

Parameters:

parentStateId - id of parent state

historyType - history type of parent state

childStateIds - child states id of parent state

defineParallelStatesOn

void defineParallelStatesOn(S parentStateId,
                          S... childStateIds)

Define sequential child states on parent state. For parallel state the history type always be none.

Parameters:

parentStateId - id of parent state

childStateIds - child states id of parent state. The first child state will be used as initial child state of parent state.

defineFinishEvent

void defineFinishEvent(E finishEvent)

Define event for parallel transition finished

Parameters:

finishEvent -

defineStartEvent

void defineStartEvent(E startEvent)

Define event for state machine started

Parameters:

startEvent -

defineTerminateEvent

void defineTerminateEvent(E terminateEvent)

Define event for state machine terminated

Parameters:

terminateEvent -

onEntry

EntryExitActionBuilder<T,S,E,C> onEntry(S stateId)

Define on entry actions for state

Parameters:

stateId - the id of state

Returns:

the builder to build state on entry actions

onExit

EntryExitActionBuilder<T,S,E,C> onExit(S stateId)

Define on exit actions for state

Parameters:

stateId - the id of state

Returns:

the builder to build state on exit actions

newStateMachine

T newStateMachine(S initialStateId)

Create a new state machine instance

Parameters:

initialStateId - initial state id

Returns:

new state machine instance

newStateMachine

T newStateMachine(S initialStateId,
                Object... extraParams)

Create new state machine instance according to state machine definition

Parameters:

initialStateId - the id of state machine initial state

extraParams - other parameters for instantiate state machine

Returns:

new state machine

newStateMachine

T newStateMachine(S initialStateId,
                StateMachineConfiguration configuration,
                Object... extraParams)

Create new state machine instance according to state machine definition

Parameters:

initialStateId - the id of state machine initial state

configuration - configuration for state machine

extraParams - other parameters for instantiate state machine

Returns:

new state machine

setStateMachineConfiguration

void setStateMachineConfiguration(StateMachineConfiguration configure)

Set default state machine configuration for state machine instance created by this builder

Parameters:

configure - state machine default configuration