com.hotels.styx.common

Class StateMachine.Builder<S>

java.lang.Object

com.hotels.styx.common.StateMachine.Builder<S>

Type Parameters:

S - state type

Enclosing class:

StateMachine<S>

public static final class StateMachine.Builder<S>
extends Object

StateMachine builder.

Constructor Summary

Constructors

Constructor and Description
Builder()

Method Summary

Modifier and Type	Method and Description
StateMachine<S>	build() Builds a new state-machine with on the configuration provided to this builder.
StateMachine.Builder<S>	initialState(S initialState) Sets the state that the state-machine should start in.
<E> StateMachine.Builder<S>	onInappropriateEvent(BiFunction<S,E,S> mapper) Determines how to handle an inappropriate event.
StateMachine.Builder<S>	onStateChange(StateChangeListener<S> stateChangeListener) Add state-change-listener to be informed about state changes, including due to inappropriate events.
<E> StateMachine.Builder<S>	transition(S state, Class<E> eventClass, Function<E,S> mapper) Associates a state and event type with a function that returns a new state and possibly side-effects.

Methods inherited from class java.lang.Object

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

Constructor Detail

Builder

public Builder()

Method Detail

initialState

public StateMachine.Builder<S> initialState(S initialState)

Sets the state that the state-machine should start in.

Parameters:

initialState - initial state

Returns:

this builder

transition

public <E> StateMachine.Builder<S> transition(S state,
                                              Class<E> eventClass,
                                              Function<E,S> mapper)

Associates a state and event type with a function that returns a new state and possibly side-effects.

Type Parameters:

E - event type

Parameters:

state - state to transition from

eventClass - event class

mapper - function that returns the new state

Returns:

this builder

onInappropriateEvent

public <E> StateMachine.Builder<S> onInappropriateEvent(BiFunction<S,E,S> mapper)

Determines how to handle an inappropriate event. That is, an event that has no transition associated with the current state.

Type Parameters:

E - event type

Parameters:

mapper - function that returns the new state

Returns:

this builder

onStateChange

public StateMachine.Builder<S> onStateChange(StateChangeListener<S> stateChangeListener)

Add state-change-listener to be informed about state changes, including due to inappropriate events.

Parameters:

stateChangeListener - state-change-listener

Returns:

this builder

build

public StateMachine<S> build()

Builds a new state-machine with on the configuration provided to this builder.

Returns:

a new state-machine