什么是状态机
状态机是计算机科学中的核心建模工具，用于描述对象在其生命周期内状态变化的逻辑模型。它通过定义有限状态集合、状态转移规则和触发事件，精确控制系统的行为逻辑。
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@Overridepublic OrderStatus getCurrentState() {return status;}@Overridepublic 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 {@Injectprivate 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;}
}