DistributedStateMachine (Spring State Machine 1.2.8.RC1 API)

java.lang.Object
- org.springframework.statemachine.support.LifecycleObjectSupport
- - org.springframework.statemachine.ensemble.DistributedStateMachine<S,E>

Type Parameters:

S - the type of state

E - the type of event

All Implemented Interfaces:

org.springframework.beans.factory.Aware, org.springframework.beans.factory.BeanFactoryAware, org.springframework.beans.factory.DisposableBean, org.springframework.beans.factory.InitializingBean, org.springframework.context.Lifecycle, org.springframework.context.Phased, org.springframework.context.SmartLifecycle, Region<S,E>, StateMachine<S,E>
```
public class DistributedStateMachine<S,E>
extends LifecycleObjectSupport
implements StateMachine<S,E>
```
DistributedStateMachine is wrapping a real StateMachine and works together with a StateMachineEnsemble order to provide a distributed state machine. Every distributed state machine will enter its initial state regardless of a distributed state status.

Author:

Janne Valkealahti

Constructor Summary

Constructors
Constructor and Description
`DistributedStateMachine(StateMachineEnsemble<S,E> ensemble, StateMachine<S,E> delegate)` Instantiates a new distributed state machine.

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`void`	`addStateListener(StateMachineListener<S,E> listener)` Adds the state listener.
`protected void`	`doStart()` Subclasses may implement this method with the start behavior.
`protected void`	`doStop()` Subclasses may implement this method with the stop behavior.
`ExtendedState`	`getExtendedState()` Gets the state machine extended state.
`java.lang.String`	`getId()` Gets the region and state machine id.
`State<S,E>`	`getInitialState()` Gets the initial state `S`.
`State<S,E>`	`getState()` Gets the current `State`.
`StateMachineAccessor<S,E>`	`getStateMachineAccessor()` Gets the state machine accessor.
`java.util.Collection<State<S,E>>`	`getStates()` Gets the `State`s defined in this region.
`java.util.Collection<Transition<S,E>>`	`getTransitions()` Gets a `Transition`s for this region.
`java.util.UUID`	`getUuid()` Gets the region and state machine unique id.
`boolean`	`hasStateMachineError()` Checks for state machine error.
`boolean`	`isComplete()` Checks if region complete.
`protected void`	`onInit()` Subclasses may implement this for initialization logic.
`void`	`removeStateListener(StateMachineListener<S,E> listener)` Removes the state listener.
`boolean`	`sendEvent(E event)` Send an event `E` to the region.
`boolean`	`sendEvent(org.springframework.messaging.Message<E> event)` Send an event `E` wrapped with a `Message` to the region.
`void`	`setStateMachineError(java.lang.Exception exception)` Sets the state machine error.
`java.lang.String`	`toString()`

Methods inherited from class org.springframework.statemachine.support.LifecycleObjectSupport
afterPropertiesSet, destroy, doDestroy, getBeanFactory, getPhase, getTaskExecutor, getTaskScheduler, isAutoStartup, isRunning, setAutoStartup, setBeanFactory, setPhase, setTaskExecutor, setTaskScheduler, start, stop, stop

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface org.springframework.statemachine.region.Region
start, stop

- Constructor Detail
  - DistributedStateMachine
```
public DistributedStateMachine(StateMachineEnsemble<S,E> ensemble,
                               StateMachine<S,E> delegate)
```
    Instantiates a new distributed state machine.
    
    Parameters:
    
    ensemble - the state machine ensemble
    
    delegate - the delegating state machine
- Method Detail
  - onInit
```
protected void onInit()
               throws java.lang.Exception
```
    Description copied from class: LifecycleObjectSupport
    
    Subclasses may implement this for initialization logic. Called during the InitializingBean phase. Implementor should always call super method not to break initialization chain.
    
    Overrides:
    
    onInit in class LifecycleObjectSupport
    
    Throws:
    
    java.lang.Exception - exception
  - doStart
```
protected void doStart()
```
    Description copied from class: LifecycleObjectSupport
    
    Subclasses may implement this method with the start behavior. This method will be invoked while holding the LifecycleObjectSupport.lifecycleLock.
    
    Overrides:
    
    doStart in class LifecycleObjectSupport
  - doStop
```
protected void doStop()
```
    Description copied from class: LifecycleObjectSupport
    
    Subclasses may implement this method with the stop behavior. This method will be invoked while holding the LifecycleObjectSupport.lifecycleLock.
    
    Overrides:
    
    doStop in class LifecycleObjectSupport
  - sendEvent
```
public boolean sendEvent(org.springframework.messaging.Message<E> event)
```
    Description copied from interface: Region
    
    Send an event E wrapped with a Message to the region.
    
    Specified by:
    
    sendEvent in interface Region<S,E>
    
    Parameters:
    
    event - the wrapped event to send
    
    Returns:
    
    true if event was accepted
  - sendEvent
```
public boolean sendEvent(E event)
```
    Description copied from interface: Region
    
    Send an event E to the region.
    
    Specified by:
    
    sendEvent in interface Region<S,E>
    
    Parameters:
    
    event - the event to send
    
    Returns:
    
    true if event was accepted
  - getState
```
public State<S,E> getState()
```
    Description copied from interface: Region
    
    Gets the current State.
    
    Specified by:
    
    getState in interface Region<S,E>
    
    Returns:
    
    current state
  - getStates
```
public java.util.Collection<State<S,E>> getStates()
```
    Description copied from interface: Region
    
    Gets the States defined in this region. Returned collection is an unmodifiable copy because states in a state machine are immutable.
    
    Specified by:
    
    getStates in interface Region<S,E>
    
    Returns:
    
    immutable copy of states
  - getTransitions
```
public java.util.Collection<Transition<S,E>> getTransitions()
```
    Description copied from interface: Region
    
    Gets a Transitions for this region.
    
    Specified by:
    
    getTransitions in interface Region<S,E>
    
    Returns:
    
    immutable copy of transitions
  - isComplete
```
public boolean isComplete()
```
    Description copied from interface: Region
    
    Checks if region complete. Region is considered to be completed if it has reached its end state and no further event processing is happening.
    
    Specified by:
    
    isComplete in interface Region<S,E>
    
    Returns:
    
    true, if complete
  - setStateMachineError
```
public void setStateMachineError(java.lang.Exception exception)
```
    Description copied from interface: StateMachine
    
    Sets the state machine error.
    
    Specified by:
    
    setStateMachineError in interface StateMachine<S,E>
    
    Parameters:
    
    exception - the new state machine error
  - hasStateMachineError
```
public boolean hasStateMachineError()
```
    Description copied from interface: StateMachine
    
    Checks for state machine error.
    
    Specified by:
    
    hasStateMachineError in interface StateMachine<S,E>
    
    Returns:
    
    true, if error has been set
  - addStateListener
```
public void addStateListener(StateMachineListener<S,E> listener)
```
    Description copied from interface: Region
    
    Adds the state listener.
    
    Specified by:
    
    addStateListener in interface Region<S,E>
    
    Parameters:
    
    listener - the listener
  - removeStateListener
```
public void removeStateListener(StateMachineListener<S,E> listener)
```
    Description copied from interface: Region
    
    Removes the state listener.
    
    Specified by:
    
    removeStateListener in interface Region<S,E>
    
    Parameters:
    
    listener - the listener
  - getInitialState
```
public State<S,E> getInitialState()
```
    Description copied from interface: StateMachine
    
    Gets the initial state S.
    
    Specified by:
    
    getInitialState in interface StateMachine<S,E>
    
    Returns:
    
    initial state
  - getExtendedState
```
public ExtendedState getExtendedState()
```
    Description copied from interface: StateMachine
    
    Gets the state machine extended state.
    
    Specified by:
    
    getExtendedState in interface StateMachine<S,E>
    
    Returns:
    
    extended state
  - getStateMachineAccessor
```
public StateMachineAccessor<S,E> getStateMachineAccessor()
```
    Description copied from interface: StateMachine
    
    Gets the state machine accessor.
    
    Specified by:
    
    getStateMachineAccessor in interface StateMachine<S,E>
    
    Returns:
    
    the state machine accessor
  - getUuid
```
public java.util.UUID getUuid()
```
    Description copied from interface: Region
    
    Gets the region and state machine unique id.
    
    Specified by:
    
    getUuid in interface Region<S,E>
    
    Returns:
    
    the region and state machine unique id
  - getId
```
public java.lang.String getId()
```
    Description copied from interface: Region
    
    Gets the region and state machine id. This identifier is provided for users disposal and can be set from a various ways to build a machines.
    
    Specified by:
    
    getId in interface Region<S,E>
    
    Returns:
    
    the region and state machine id
  - toString
```
public java.lang.String toString()
```
    Overrides:
    
    toString in class java.lang.Object

Class DistributedStateMachine<S,E>

Constructor Summary

Method Summary

Methods inherited from class org.springframework.statemachine.support.LifecycleObjectSupport

Methods inherited from class java.lang.Object

Methods inherited from interface org.springframework.statemachine.region.Region

Constructor Detail

DistributedStateMachine

Method Detail

onInit

doStart

doStop

sendEvent

sendEvent

getState

getStates

getTransitions

isComplete

setStateMachineError

hasStateMachineError

addStateListener

removeStateListener

getInitialState

getExtendedState

getStateMachineAccessor

getUuid

getId

toString