C#状态机Stateless

最近在折腾一些控制相关的软件设计,想起来状态机这个东西,对解决一些控制系统状态切换还是挺有用的。

状态机(有限状态自动机)网上有很多介绍。简单理解就是定义一系列状态,通过一系列的事件,可以使得状态可以相互之间切换。

如果不使用状态机的思想来编程,那么针对过程的编程方法会使得程序拓展性变差,并且不容易调试。而状态机只需要定义好了各种状态和状态切换之间的事件,你只管触发事件,剩下的事情它自己就自动完成了(毕竟名称叫做有限状态自动机),这对于很多需要定义各种控制阶段的系统简直是完美适配。了解到.NET也有很多库可以实现这些功能,本文主要介绍一下Stateless的应用。

Stateless介绍

Stateless可以创建极简的状态机与对应的工作流。很多项目(包括VisualStudio Extension、AIlab)都有使用到它。

它支持以下特性:

  • 支持各种类型作为状态和触发事件
  • 支持状态继承
  • 支持状态进入/离开事件
  • 支持条件状态转移
  • 支持状态/转移查询

也有几点需要注意的:

  • 它支持异步语法,但是它是单线程的,不是线程安全的。
  • 可以导出DOT graph

安装起来很简单,直接在nuget中安装即可:

Install-Package Stateless

Stateless使用

用起来也挺简单的,以打电话这个事情为例,针对打电话的种种动作和状态做成一个状态机。
需要先定义一些状态和事件/触发器,电话有拨号、接通、留言等事件,有响铃、挂起、挂断等事件:

//代码来自官方示例,可以在官方github库上找到,略有修改以完整展示功能。
enum Trigger
{
    CallDialed,CallConnected,LeftMessage,PlacedOnHold,TakenOffHold,PhoneHurledAgainstWall,MuteMicrophone,UnmuteMicrophone,SetVolume
}

enum State
{
    OffHook,Ringing,Connected,OnHold,PhoneDestroyed
}

然后就是创建一个状态机了:

_machine = new StateMachine<State,Trigger>(() => _state,s => _state = s);

最后也是最需要详细解释的,就是配置状态机的行为了:

/*
为了解释尽可能多的功能,以下程序修改了官方的代码,可以在官方找可以直接执行的代码。
*/

//使用Permit指示发生某个事件后,从一个状态变换到另外一个状态。
_machine.Configure(State.OffHook)
    .Permit(Trigger.CallDialed,State.Ringing);

//设置一个带参数的事件,这个事件是CallDialed的类型
var _setCalleeTrigger = _machine.SetTriggerParameters<string>(Trigger.CallDialed);
_machine.Configure(State.Ringing)
    //允许重新进入当前的状态,这个过程会触发进入和退出动作
    .PermitReentry(Trigger.Ringing)
    //使用OnEntryFrom指示在触发这个状态的时候,运行某个动作,这里指定的是一个带参数的事件
    .OnEntryFrom(_setCalleeTrigger,callee => OnDialed(callee),"Caller number to call")
    .Permit(Trigger.CallConnected,State.Connected);

_machine.Configure(State.OnHold)
    //定义子状态
    .SubstateOf(State.Connected)
    .Permit(Trigger.TakenOffHold,State.Connected)
    .Permit(Trigger.PhoneHurledAgainstWall,State.PhoneDestroyed);

_machine.Configure(State.Connected)
    //进入状态的时候执行动作
    .OnEntry(t => StartCallTimer())
    //离开状态执行动作
    .OnExit(t => StopCallTimer())
    //状态不变化,但是响应某种事件,和PermitReentry不同,它不会触发进入和退出的动作
    .InternalTransition(Trigger.MuteMicrophone,t => OnMute())
    .InternalTransition(Trigger.UnmuteMicrophone,t => OnUnmute())
    .InternalTransition<int>(_setVolumeTrigger,(volume,t) => OnSetVolume(volume))
    .Permit(Trigger.LeftMessage,State.OffHook)
    .Permit(Trigger.PlacedOnHold,State.OnHold)
    //指定在发生同一种事件的时候,根据事件的参数不同而决定进入不同的状态。
    .PermitIf(_setCalleeTrigger,State.Connected,callee => string.IsNullOrWhiteSpace(callee))
    .PermitIf(_setCalleeTrigger,callee => !string.IsNullOrWhiteSpace(callee))
    //如果没有定义这个事件而发生了这个事件,会弹出异常。通过指定忽略某一类事件,可以避免这个情况。
    .Ignore(Trigger.CallDialled);

//当然也可以使用这个来避免弹出上面说的异常
_machine.OnUnhandledTrigger((state,trigger) => { });

//可以使用异步调用,但是必须要在触发事件的时候,使用FireAsync
_machine.Configure(State.PhoneDestroyed)
    .OnEntryAsync(async () => await SendEmailToAssignee());

配置好了各状态之间的转换,下面就是触发事件了。

public void Dialed(string callee)
{
    //有参数的触发
    _machine.Fire(_setCalleeTrigger,callee);
}

public void Connected()
{
    //无参数的触发
    _machine.Fire(Trigger.CallConnected);
}

public async Task PhoneDestroy()
{
    //异步触发
    await _machine.FireAsync(Trigger.PhoneDestroyed);
}

public string ToDotGraph()
{
    //导出DOT GRAPH
    return UmlDotGraph.Format(_machine.GetInfo());
}

外部调用很简洁:

phoneCall.Dialed("Prameela");
phoneCall.Connected();
phoneCall.SetVolume(2);
phoneCall.Hold();

只需要调用事件即可,别的都会按照我们设置好的动作来进行了,非常自动化。

总结

Stateless可以很好地实现状态机,有点事件驱动的编程的感觉,但本质上不同,Stateless核心是各个状态的迁移。

虽然Stateless很小巧方便,但是还有有很多地方不尽如人意(官方说这就是他们自己的设计目标,维持极简):

  • 没有启动和停止的说法,一般在构造函数里面创建就一直有效。
  • 不是线程安全的
  • 拓展性有限

还有一个Appccelerate.StateMachine地址),这个支持四种不同的状态机实现:

  • Passive State Machine: 同步单线程处理状态转换
  • Active State Machine: 同步多线程处理状态转换
  • Async Passive State Machine: 异步单线程处理状态转换
  • Async Active State Machine: 异步多线程处理状态转换

其中active的是线程安安全的。另外,它还支持状态、事件的持久化,拓展性强。用法差不多,只是配置的关键字上面有一点区别,大家可以自行翻文档。

版权声明:本文内容由互联网用户自发贡献,该文观点与技术仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容, 请发送邮件至 dio@foxmail.com 举报,一经查实,本站将立刻删除。

相关推荐


fastjson2 是 fastjson 项目的重要升级,目标是为下一个十年提供一个高性能的 JSON 库,同一套 API 支持JSON/JSONB 两种协议,JSONPath 是一等公民,支持全量解析和部分解析,支持 Java 服务端、客户端Android、大数据场景。 fastjson 2 代码
博文目录文章目录问题描述解决方案问题描述阿里云ECS, 系统切换为 Aliyun Linux 2.1903 LTS 64位 后, SSH可以连接, SFTP无法连接, 端口 22 已添加到阿里云ECS网络安全组表现为 Xshell 可以连接, Xftp 使用 SFTP 协议无法连接, 一片空白, 很长时间也不报错提示, 鼠标挪动的时候显示为圆圈(等待响应)解决方案将 /etc/ssh/sshd_config 中的Subsystem sftp /usr/libexec/opens
博文目录文章目录创建项目创建代码仓库完成工程代码并提交推送到仓库application.propertiespom.xml创建构建计划设置流程配置阶段说明 测试阶段说明 部署定义远程服务器信息远程服务器鉴权创建 SSH 密钥录入凭据在 持续集成 的 构建脚本 中做 SSH 鉴权操作远程服务器设置触发规则设置变量与缓存CODING 持续集成 帮助文档当下 DevOps, CI/CD 等概念非常火, 我自己也想试试, 碰巧知道 CODING.NET 免费提供了这个能力, 所以来尝试一把, 好在最终有
下载CentOS官网CentOS下载CentOS-7-x86_64-DVD-2003.isoCentOS-7-x86_64-DVD-2003.iso安装
博文目录文章目录服务端客户端测试效果服务端配置到 nginx 反向代理FRP Releases使用frp进行内网穿透FRP 示例FRP 实例 通过自定义域名访问内网的 Web 服务FRP 参考 服务端配置FRP Linux Server ReleaseFRP Windows Client Release服务端在 linux 上执行 arch, 结果如果是 [X86_64] 即可选择 [linux amd64] 版本的 Release 包wget https://github.co
博文目录文章目录环境下载安装配置使用环境阿里云ECS(Aliyun Linux 2.1903 LTS 64位)下载https://www.oracle.com/java/technologies/oracle-java-archive-downloads.htmlJava SE 8 (8u202 and earlier) 可以用于商业Java SE 8 (8u211 and later) 不可以用于商业安装tar -zxvf jdk-8u202-linux-x64.tar.gz 得到
博文目录文章目录环境下载安装配置使用环境阿里云ECS(Aliyun Linux 2.1903 LTS 64位)下载https://maven.apache.org/download.cgi安装tar -zxvf apache-maven-3.6.3-bin.tar.gz 得到解压包配置在 /root/.bashrc 文件内添加如下内容export MAVEN_HOME=/mrathena/application/maven-3.6.3export PATH=$JAVA_HOME/
博文目录文章目录嵩山版(2020.08.03)阿里开发手册官网嵩山版(2020.08.03)手册的详细版叫做 码出高效
博文目录文章目录EncodingFontMavenGradleOtherPluginsEncodingsetting 搜索 encodFile | Settings | Editor | File Encodings, 3个 UTF-8File | Settings | Tools | SSH Terminal, 1个 UTF-8Fontsetting 搜索 fontFile | Settings | Editor | FontMavensetting 搜索 mavenFile |
博文目录文章目录环境下载安装配置使用参考环境阿里云ECS(Aliyun Linux 2.1903 LTS 64位)下载http://nginx.org/en/download.htmlhttp://nginx.org/download/nginx-1.18.0.tar.gz选择稳定版(Stable version)下载即可, 分 linux 和 windows 两种, linux 版下载的是源码, 需要自行编译安装tar -zxvf nginx-1.18.0.tar.gz 得到解压包
博文目录文章目录单密钥方式多密钥方式默认生成的 rsa密钥位置在 ~/.ssh, 如 C:Usersmrathena.ssh. 各代码托管平台是可以使用同一个SSH密钥的, 这样最方便, 但是为了更安全也可以配置在不同的平台使用不同的密钥单密钥方式cmd 执行命令 ssh-keygen -t rsa -b 4096 -C "generic", -t type rsa, -b 位数 4096位, 如果不用 -C 指定邮箱, 则会生成一个默认的注释, 该注释无关紧要, 不影响验证选项全部默认(
博文目录文章目录环境下载安装配置使用参考环境阿里云ECS(Aliyun Linux 2.1903 LTS 64位)下载https://github.com/git/git/releaseshttps://codeload.github.com/git/git/tar.gz/v2.28.0, 下载之后可以重命名为 git-2.28.0.tar.gz安装tar -zxvf apache-maven-3.6.3-bin.tar.gz 得到解压包make prefix=/mrathena/a
博文目录文章目录环境下载安装简单配置汉化皮肤JDKMaven简单使用环境阿里云ECS(Aliyun Linux 2.1903 LTS 64位)下载Jenkins 官网, 支持选择中文https://www.jenkins.io/选择 LTS 长期支持版的最新版下载, 这里是 2.235.3 LTS, Generic Java package (.war) 是 java war 包, 可以通过 java -jar jenkins.war 直接运行官网下载 wget http://mir
原因分析 是因为使用了pycharm的版本的问题。并不是flask框架本身的问题(不管你是如何设置的flask配置,通过加载config也好,还是通过run的时候传入形参也好,均不影响) 可以很明显的
背景 兜兜转转以为做测试不用接触这么多编程,结果不仅要接触 py,还要接触 java,还有 elixir,更有 Lua,啊 我绝望了 太久没玩 Java,连导入项目都不会了...特此记录一下侮辱性的时
1. 安装制作工具 mkisofs 2. Linux 操作系统镜像 iso 打包 3. 校验并写入 md5 值
最近在学习 MySQL 的 bin-log 时候考虑到数据备份的问题,突然想到如果能将数据通过 Linux 命令行方式备份到百度网盘,那是一件多么牛逼的事情。百度网盘有免费的 2TB 存储空间,而且有
作为一名开发者,熟悉使用 git 代码管理工具是一项必备的基本技能。git 相较 SVN 而言,其优点不言而喻。git 的功能非常强大,其包括的操作命令也非常的多,但是从实用性而言,很多命令可能我们一
kickstart 能实现 linux 系统的自动化安装,需要设置 ks.cfg 文件,而这个 ks.cfg 文件的生成最好使用 system-config-kickstart 工具生成,比较准确,也
介绍 GitBook是一个基于Node.js的命令行工具,可使用 Github/Git和Markdown来制作精美的电子书,GitBook 并非关 Git的教程。 导出格式有PDF、HTML等,需要添