聊聊Cola-StateMachine轻量级状态机的实现

作者: 来源: 博客园 2023-06-07 14:44:46

 背景

在分析Seata的saga模式实现时,实在是被其复杂的 json 状态语言定义文件劝退,我是有点没想明白为啥要用这么来实现状态机;盲猜可能是基于可视化的状态机设计器来定制化流程,更方便快捷且上手快吧,毕竟可以通过UI直接操作,设计状态流转图,但我暂时不太能get到。对于Saga模式的实现,之前的博文中已经阐述了基于状态机模式实现Saga,是比较常见且合适的做法,因此了解了下Java中的状态机实现方案,以后有相关的业务场景也可以直接上手使用状态机。

Cola-StateMachine

Cola-StateMachine组件是一种轻量级的、无状态的、基于注解的状态机实现,可以方便地管理订单等业务对象的状态转换。COLA框架的状态机使用了连贯接口(Fluent Interfaces)来定义状态和事件,以及对应的动作和检查。COLA框架的状态机是COLA 4.0应用架构的一部分,旨在控制复杂度,提高开发效率。开发背景可见实现一个状态机引擎,教你看清DSL的本质。

基础模型

在Cola-StateMachine组件中有如下的抽象概念模型:


【资料图】

1.State:状态2.Event:事件,状态由事件触发,引起变化3.Transition:流转,表示从一个状态到另一个状态4.External Transition:外部流转,两个不同状态之间的流转5.Internal Transition:内部流转,同一个状态之间的流转6.Condition:条件,表示是否允许到达某个状态7.Action:动作,到达某个状态之后,可以做什么8.StateMachine:状态机

Cola-StateMachine链路图业务应用示例

基于订单业务的场景,做一个简单的demo。

关闭订单的简单流程图

关闭订单简单的状态流转图

添加依赖

    com.alibaba.cola    cola-component-statemachine    4.3.1

定义一个订单的实体类、订单状态的枚举值、订单事件的枚举值

@Data@Builderpublic class Order {    public OrderStatusEnum orderStatusEnum;    public Integer orderId;    public String orderName;}public enum OrderStatusEnum {    INIT("0", "待付款"),    WAITING_FOR_DELIVERY("1", "待发货"),    HAVE_BEEN_DELIVERY("2", "已发货"),    CLOSE("3", "已取消");    private final String code;    private final String info;    OrderStatusEnum(String code, String info)    {        this.code = code;        this.info = info;    }    public String getCode()    {        return code;    }    public String getInfo()    {        return info;    }}public enum OrderEvent {    /**     * 用户关闭     */    USER_CLOSE("0", "用户取消"),    /**     * 管理员关闭     */    ADMIN_CLOSE("1", "后台取消"),    /**     * 超时关闭     */    OVERTIME_CLOSE("2", "超时取消"),    /**     * 检查错误关闭     */    CHECK_ERROR_CLOSE("3", "上级审核取消"),    /**     * 用户付费     */    USER_PAY("4", "用户支付");    /**     * 密码     */    private final String code;    /**     * 信息     */    private final String info;    /**     * 订单事件     *     * @param code 密码     * @param info 信息     */    OrderEvent(String code, String info) {        this.code = code;        this.info = info;    }    /**     * 获取代码     *     * @return {@link String}     */    public String getCode() {        return code;    }    /**     * 获取信息     *     * @return {@link String}     */    public String getInfo() {        return info;    }}

在容器启动的时候注册一个订单状态变更的工厂

@Componentpublic class StateMachineBuilderConfig {    @Autowired    UserCloseAction userCloseAction;    @Bean("orderOperaMachine")    public StateMachine orderOperaMachine() {        String ORDER_OPERA = "order_opera";        StateMachineBuilder builder = StateMachineBuilderFactory.create();        //订单从初始化状态-待发货-状态-转到-关闭订单状态--用户关闭        builder.externalTransitions()                .fromAmong(OrderStatusEnum.INIT, OrderStatusEnum.WAITING_FOR_DELIVERY)                .to(OrderStatusEnum.CLOSE)                .on(OrderEvent.USER_CLOSE)                .when(checkCondition())                .perform(userCloseAction);        //订单从-初始化状态-已发货-待发货--转到-关闭订单状态--后台操作人员关闭        builder.externalTransitions()                .fromAmong(OrderStatusEnum.INIT, OrderStatusEnum.HAVE_BEEN_DELIVERY, OrderStatusEnum.WAITING_FOR_DELIVERY)                .to(OrderStatusEnum.CLOSE)                .on(OrderEvent.ADMIN_CLOSE)                .when(checkCondition())                .perform(doAction());        //订单从等待发货状态-转为-订单关闭状态-超时关闭        builder.externalTransition()                .from(OrderStatusEnum.WAITING_FOR_DELIVERY)                .to(OrderStatusEnum.CLOSE)                .on(OrderEvent.OVERTIME_CLOSE)                .when(checkCondition())                .perform(doAction());        //订单从待发货状态--转为-订单关闭状态-上级审批不通过关闭        builder.externalTransition()                .from(OrderStatusEnum.WAITING_FOR_DELIVERY)                .to(OrderStatusEnum.CLOSE)                .on(OrderEvent.CHECK_ERROR_CLOSE)                .when(checkCondition())                .perform(doAction());        //订单从初始化状态--转为待发货状态--用户支付完毕动        builder.externalTransition()                .from(OrderStatusEnum.INIT)                .to(OrderStatusEnum.WAITING_FOR_DELIVERY)                .on(OrderEvent.USER_PAY)                .when(checkCondition())                .perform(doAction());        StateMachine orderOperaMachine = builder.build(ORDER_OPERA);        //打印uml图        String plantUML = orderOperaMachine.generatePlantUML();        System.out.println(plantUML);        return orderOperaMachine;    }    private Condition checkCondition() {        return (ctx) -> {            return true;        };    }    private Action doAction() {        return (from, to, event, ctx) -> {            System.out.println(ctx.getOrderName() + " 正在操作 " + ctx.getOrderId() + " from:" + from + " to:" + to + " on:" + event);        };    }}

在定义一个特殊的,只是举个例子,可以通过集成的方式集成实现一个用户关单的具体操作

@Componentpublic class UserCloseAction implements Action {    @Override    public void execute(OrderStatusEnum from, OrderStatusEnum to, OrderEvent event, Order context) {        System.out.println("用户关闭流程开始走了");        System.out.println("从这个状态-【" + from.getInfo() + "】-转为+【" + to.getInfo() + "】 的状态");        System.out.println("上下文信息:" + context.toString());        System.out.println("中间执行的一些操作.......");        System.out.println("用户关闭流程完毕了");    }}

定义一个 controller 的操作接口

@RestControllerpublic class OrderOperaController {    @Autowired    @Qualifier("orderOperaMachine")    StateMachine orderOperaMachine;    /**     * 场景1-用户关闭订单     *     * @return {@link Boolean}     */    @RequestMapping("userclose")    public Boolean userCloseOrder() {        //把订单状态改为关闭        String machineId = orderOperaMachine.getMachineId();        System.out.println(machineId);        Order order = Order.builder().orderId(1).orderName("用户").orderStatusEnum(OrderStatusEnum.INIT).build();        OrderStatusEnum orderStatusEnum = orderOperaMachine.fireEvent(OrderStatusEnum.INIT,OrderEvent.USER_CLOSE, order);        System.out.println(orderStatusEnum.toString());        return true;    }    /**     * 场景2-管理员关闭订单     *     * @return {@link Boolean}     */    @RequestMapping("adminClose")    public Boolean adminCloseOrder() {        //把订单状态改为关闭        Order order = Order.builder().orderId(1).orderName("后台操作人员").orderStatusEnum(OrderStatusEnum.HAVE_BEEN_DELIVERY).build();        OrderStatusEnum orderStatusEnum = orderOperaMachine.fireEvent(OrderStatusEnum.HAVE_BEEN_DELIVERY, OrderEvent.ADMIN_CLOSE, order);        System.out.println(orderStatusEnum.toString());        return true;    }    /**     * 场景3-超时关闭订单     *     * @return {@link Boolean}     */    @RequestMapping("overTimeclose")    public Boolean overTimeCloseOrder() {        //把订单状态改为关闭        Order order = Order.builder().orderId(1).orderName("超时了关闭订单")                .orderStatusEnum(OrderStatusEnum.WAITING_FOR_DELIVERY).build();        //OrderStatusEnum orderStatusEnum = orderOperaMachine.fireEvent(OrderStatusEnum.CLOSE, OrderEvent.OVERTIME_CLOSE, order);        OrderStatusEnum orderStatusEnum = orderOperaMachine.fireEvent(OrderStatusEnum.WAITING_FOR_DELIVERY, OrderEvent.OVERTIME_CLOSE, order);        System.out.println(orderStatusEnum.toString());        return true;    }    /**     * 场景4-检查错误关闭订单     *     * @return {@link Boolean}     */    @RequestMapping("checkErrorClose")    public Boolean checkErrorCloseOrder() {        //把订单状态改为关闭        Order order = Order.builder().orderId(1).orderName("上级检查错误").orderStatusEnum(OrderStatusEnum.WAITING_FOR_DELIVERY).build();        OrderStatusEnum orderStatusEnum = orderOperaMachine.fireEvent(OrderStatusEnum.WAITING_FOR_DELIVERY, OrderEvent.CHECK_ERROR_CLOSE, order);        System.out.println(orderStatusEnum.toString());        return true;    }}

启动程序

安装UML

随便新建一个uml文件,然后将启动程序的控制台输出内容复制到uml中

最后运行下

 

相关文章
最近更新
  • 聊聊Cola-StateMachine轻量级状态机的实现

    聊聊Cola-StateMachine轻量级状态机的实现

    2023-06-07

  • 当前视点!必须等!多位记者:巴萨不能立即签梅西,是否继续等待取决他自己

    当前视点!必须等!多位记者:巴萨不能立即签梅西,是否继续等待取决他自己

    2023-06-07

  • 记者:别无选择,梅西需要耐心等待,球迷:巴萨耍流氓 今日快讯

    记者:别无选择,梅西需要耐心等待,球迷:巴萨耍流氓 今日快讯

    2023-06-07

  • 回归巴萨之路被堵死!下一站梅西选多金沙特,还是小贝的迈阿密 全球快消息

    回归巴萨之路被堵死!下一站梅西选多金沙特,还是小贝的迈阿密 全球快消息

    2023-06-07

  • 信用卡呆账多久会被起诉?呆账的原因是什么

    信用卡呆账多久会被起诉?呆账的原因是什么

    2023-06-07

  • 焦点热讯:世行上调今年全球和中国经济增长预期

    焦点热讯:世行上调今年全球和中国经济增长预期

    2023-06-07

  • 全球资讯:郑州日产七座商务车最低价格(郑州日产七座商务车)

    全球资讯:郑州日产七座商务车最低价格(郑州日产七座商务车)

    2023-06-07

  • 四大咨询公司的报告百度网盘(四大咨询公司是指) 通讯

    四大咨询公司的报告百度网盘(四大咨询公司是指) 通讯

    2023-06-07

  • 要闻速递:唱歌练气(如何练气唱歌)

    要闻速递:唱歌练气(如何练气唱歌)

    2023-06-07

  • ph计电极保护液怎么配(ph计电极保护液)_热议

    ph计电极保护液怎么配(ph计电极保护液)_热议

    2023-06-07

  • 格罗西:国际原子能机构专家组将赴扎波罗热核电站考察-世界独家

    格罗西:国际原子能机构专家组将赴扎波罗热核电站考察-世界独家

    2023-06-07

  • 世界即时:大唐潮州发电施“凉策”开“凉方”让职工清凉度夏

    世界即时:大唐潮州发电施“凉策”开“凉方”让职工清凉度夏

    2023-06-07

  • 热讯:贵州电网多举措保高考用电无忧

    热讯:贵州电网多举措保高考用电无忧

    2023-06-07

  • 中国航发:@各位高考生,如果你想写航空发动机-天天热闻

    中国航发:@各位高考生,如果你想写航空发动机-天天热闻

    2023-06-07

  • 液冷服务器,谁是盈利最强企业?|环球播资讯

    液冷服务器,谁是盈利最强企业?|环球播资讯

    2023-06-07

  • 惠安县委、县政府主要领导带队检查巡视高考考点

    惠安县委、县政府主要领导带队检查巡视高考考点

    2023-06-07

  • 局长谈营商——惠安县市场监督管理局:“改革+服务+监管” 助力优化营商环境 世界资讯

    局长谈营商——惠安县市场监督管理局:“改革+服务+监管” 助力优化营商环境 世界资讯

    2023-06-07

  • 深圳市龙岗区第五人民医院第三批招聘劳务派遣人员岗位表|全球百事通

    深圳市龙岗区第五人民医院第三批招聘劳务派遣人员岗位表|全球百事通

    2023-06-07

  • 广东惠州各级工会投26万元服务新业态劳动者6000人次

    广东惠州各级工会投26万元服务新业态劳动者6000人次

    2023-06-07

  • 今亮点!10名中国选手赌球被禁赛,中国台球协会回应

    今亮点!10名中国选手赌球被禁赛,中国台球协会回应

    2023-06-07

  • 全球热议:雨后初霁 云雾醉漳城

    全球热议:雨后初霁 云雾醉漳城

    2023-06-07

  • 26场12球!34岁国脚惊艳吊射,成巴甲队内第一射手,却被国足抛弃 每日视点

    26场12球!34岁国脚惊艳吊射,成巴甲队内第一射手,却被国足抛弃 每日视点

    2023-06-07

  • 上午11点!洛国富再进球!未能入选国足,曾被名记批评体能不足 环球播资讯

    上午11点!洛国富再进球!未能入选国足,曾被名记批评体能不足 环球播资讯

    2023-06-07

  • 前沿热点:交游广阔!巴特勒为内马尔博格巴接风,请博格巴吃高档日料亲自烤肉

    前沿热点:交游广阔!巴特勒为内马尔博格巴接风,请博格巴吃高档日料亲自烤肉

    2023-06-07

  • 滞困异星黎明CALM-TUNE种子是什么

    滞困异星黎明CALM-TUNE种子是什么

    2023-06-07

  • 暗黑4通用装备无星之空戒指有什么特点

    暗黑4通用装备无星之空戒指有什么特点

    2023-06-07

  • 当前快讯:暗黑4赋能收割者之威能介绍

    当前快讯:暗黑4赋能收割者之威能介绍

    2023-06-07

  • vivo S17系列明日开售 S系列人像拍照巅峰体验

    vivo S17系列明日开售 S系列人像拍照巅峰体验

    2023-06-07

  • 美国纽约市警察局联邦监察员:警方对有色人种滥用“截停搜身”

    美国纽约市警察局联邦监察员:警方对有色人种滥用“截停搜身”

    2023-06-07

  • 联络方式公布!

    联络方式公布!

    2023-06-07