C# 状态机 Stateless 3.0

目录标题

Stateless 简介
Stateless 简单用法
Stateless 初级用法
Stateless 进阶用法
.net 库集合

Stateless 简介

Stateless 是基于 C# 实现状态机的库。详见 Github - Stateless

Stateless 简单用法

1 - 定义状态（State）以及不同状态间转换的触发器（Trigger）。
简例中用枚举类型定义 State 及 Trigger：

enum State
{state1,state2,state3
}enum Trigger
{trigger1,trigger2
}

2 - 定义状态机对象：

StateMachine<State, Trigger> _machine = new StateMachine<State, Trigger>(State.state1);

某一时刻，状态机 _machine 处于某一状态，比如 state1，此时通过不同的 Trigger 可以触发该状态机转变到不同的状态。至于，状态机处于各个状态时，不同的 Trigger 会触发其转换到何种状态，需要对状态机进行配置。

3 - 配置状态机对象：

_machine.Config(State.state1).Permit(Trigger.trigger1, State.state2).Permit(Trigger.trigger2, State.state3);_machine.Config(State.state2).Permit(Trigger.trigger1, State.state3).Permit(Trigger.trigger2, State.state1);

在该配置下，当 _machine 处于 State.state1 时，Trigger.trigger1 可触发其转换到 State.state2 状态, Trigger.trigger2 可触发其转换到 State.state3 状态；当_machine 处于 State.state2 时，Trigger.trigger1 可触发其转换到 State.state3 状态, Trigger.trigger2 可触发其转换到 State.state1 状态。以此类推。

4 - 状态机状态改变触发函数

_machine.Fire(Trigger.trigger1);

当某事件发生时，可通过 .Fire(Trigger tg) 函数触发状态机的状态转换。

Stateless 初级用法

下面介绍一些 Stateless 的基本函数及用法。

1 - Stateless 在某状态下执行的函数。
我们在使用状态机时，不仅希望能通过一定的逻辑设置，使得状态机响应某些事件（Trigger）时，能够转入特定的状态。同时，我们还希望状态机在处于某种状态，或状态转换时，能够执行一些用户操作。Stateless 通过设定一系列的 Action 来实现这样的功能。

_machine.Config(State.state1).OnEntry(t => state1Entry()).OnExit(t => state1Exit()).InternalTransition(Trigger.triggerX, t => state1Tick()).Permit(Trigger.trigger1, State.state2).Permit(Trigger.trigger2, State.state3);void state1Entry() { /* 函数实现 */ }
void state1Exit() { /* 函数实现 */ }
void state1Tick() { /* 函数实现 */ }

其中，.OnEntry(t => state1Entry()) 设置了状态机在由其他状态进入到 State.state1 时执行的用户操作。用户操作通过函数 state1Entry() { /* 函数实现 */ } 实现。.OnExit(t => state1Exit()) 同理，可以实现离开状态State.state1 时的用户操作。
.InternalTransition(Trigger.triggerX, t => state1Tick()) 可以认为是状态机被设置为，在触发器 Trigger.triggerX 作用下可以重复进入State.state1。比如定时器重复触发事件，执行 _machine.Fire(Trigger.triggerX); 可以使状态机重复 State.state1 状态，即实现 InternalTransition 。此时，执行用户操作 state1Tick() { /* 函数实现 */ } 。

2 - 带参数触发 Trigger with parameter
有时候，某事件发生时，我们不仅希望能触发状态机转换状态，还希望能同时传递一些参数。比如，当定时器事件时，触发状态机重复 State.state2 的 internalTransation，并执行 state2Tick( float tic ) 函数，并将定时器的时间传递给该函数。那么，这里就需要用到带参数的触发。

StateMachine<State, Trigger>.TriggerWithParameters<int> _TriggerP= _machine.SetTriggerParameters<int>(Trigger.TriggerP);_machine.Config(State.state2).InternalTransition(_TriggerP, (tick, t) => state2Tick(tic));void state2Tick( int tic ) { /* 函数实现 */ }_machine.Fire(_TriggerP, 100);

同样还有

StateMachine<State, Trigger>.TriggerWithParameters<float> _TriggerP2= _machine.SetTriggerParameters<float>(Trigger.TriggerP2);
_machine.Config(State.state2).PermitIf<float>(_TriggerP2, State3, tp => !ckBool(tp)).PermintIf<float>(_TriggerP2, State1, tp => ckBool(tp));bool ckBool( float tp) { /* 判断返回布尔值*/ }

通过该配置，触发 _TriggerP2 时，同时传递参数 float tp ，通过函数 ckBool( tp ) 的真假，决定状态机转入 State.state3 或者 State.state1 。这样增加了状态机的灵活性。

3 - 其他

// on transition action_machine.OnTransitioned(OnTransitionedAction);// on unhandled trigger_machine.OnUnhandledTrigger(OnUnhandledTrigger);void OnTransitionedAction(StateMachine<State, Trigger>.Transition act) { /* 函数实现 */ }void OnUnhandledTrigger(State st, Trigger tg) { /* 函数实现 */ }

如果出现未配置的触发，可以通过设置 .OnUnhandledTrigger(OnUnhandledTrigger) 进行处理。

Stateless 进阶用法

待续

.net 库集合

github 上有大神整理收集了许多优秀的 .net library，如
SharpSCADA
awesome-dotnet-core
awesome-dotnet
ReactiveUI