Solon StateMachine 实现状态机使用示例详解

什么是状态机

状态机是计算机科学中的核心建模工具，用于描述对象在其生命周期内状态变化的逻辑模型。它通过定义有限状态集合、状态转移规则和触发事件，精确控制系统的行为逻辑。

Solon StateMachine 是 Solon Framework 提供的一个功能强大的状态机框架，可实现复杂的工作流、订单管理等需要状态流转的场景。通过对状态、事件和转移的管理，开发者能够构建出简洁而灵活的状态机逻辑。

使用示例

1、导入maven依赖

<dependency>     <groupId>org.noear</groupId>     <artifactId>solon-statemachine</artifactId>     <version>3.5.0</version> </dependency> 

2、创建订单状态枚举类

import org.noear.solon.statemachine.State;  public enum OrderStatus implements State{     WAITING_PAYMENT,//待支付     WAITING_RECEIVE,//待取货     FINISHED,//已完成     CANCELED;//已取消 } 

3、创建订单转悠事件枚举类

import org.noear.solon.statemachine.Event;  public enum OrderEvent implements Event {     CREATE_ORDER,//创建订单     PAY_ORDER,//支付订单     RECEIVE_ORDER,//取货     CANCEL_ORDER,//取消订单     FINISH_ORDER//完成订单 } 

4、创建订单实体，并实现 EventContext 接口（也可以不实现，改用 EventContext.of(...)）

public class Order implements EventContext<OrderStatus, Order> {     private final String orderId;     private OrderStatus status;      public Order(String orderId, OrderStatus status) {         this.orderId = orderId;         this.status = status;     }      public String getOrderId() {         return orderId;     }      public OrderStatus getStatus() {         return status;     }      public void setStatus(OrderStatus status) {         this.status = status;     }      // for EventContext      @Override     public OrderStatus getCurrentState() {         return status;     }      @Override     public Order getPayload() {         return this;     } } 

5、定义订单状态机组件，并添加状态转移规则。这里是重点了

Solon StateMachine 不管理当前状态，不涉及持久化。具有可复用、多线程安全特性。

import org.noear.solon.annotation.Managed; import org.noear.solon.statemachine.StateMachine;  @Managed public class OrderStateMachine extends StateMachine<OrderStatus, OrderEvent,Order> {     public OrderStateMachine() {         // 订单待支付 -> 待取货         addTransition(t -> t                 .from(OrderStatus.WAITING_PAYMENT)                 .to(OrderStatus.WAITING_RECEIVE)                 .on(OrderEvent.PAY_ORDER)                 .then(c -> c.getPayload().setStatus(c.getTo())));          // 订单待取货 -> 已完成         addTransition(t -> t                 .from(OrderStatus.WAITING_RECEIVE)                 .to(OrderStatus.FINISHED)                 .on(OrderEvent.FINISH_ORDER)                 .then(c -> c.getPayload().setStatus(c.getTo())));          // 订单待支付 -> 已取消         addTransition(t -> t                 .from(OrderStatus.WAITING_PAYMENT)                 .to(OrderStatus.CANCELED)                 .on(OrderEvent.CANCEL_ORDER)                 .then(c -> c.getPayload().setStatus(c.getTo())));     } } 

6、创建调用示例服务

Solon StateMachine 在发送事件时，通过 EventContext 传递当前状态和装载。

@Managed public class OrderService {     @Inject     private OrderStateMachine orderStateMachine;      //支付     public Order pay() {         Order order = new Order("1", OrderStatus.WAITING_RECEIVE);          System.out.println("尝试支付，订单号：" + order.getOrderId());          try {             //事件： 支付, 状态转换：待支付 → 待发货             orderStateMachine.sendEvent(OrderEvent.PAY_ORDER, order);              System.out.println("支付成功，订单号：" + order.getOrderId());         } catch (Exception ex) {             System.out.println("支付失败, 状态异常，订单号：" + order.getOrderId());         }          return order;     } }