葛雅隽 发表于 前天 11:06

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

什么是状态机

状态机是计算机科学中的核心建模工具,用于描述对象在其生命周期内状态变化的逻辑模型。它通过定义有限状态集合、状态转移规则和触发事件,精确控制系统的行为逻辑。
Solon StateMachine 是 Solon Framework提供的一个功能强大的状态机框架,可实现复杂的工作流、订单管理等需要状态流转的场景。通过对状态、事件和转移的管理,开发者能够构建出简洁而灵活的状态机逻辑。
使用示例

1、导入maven依赖

<dependency>
    <groupId>org.noear</groupId>
    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;
    }
}
来源:程序园用户自行投稿发布,如果侵权,请联系站长删除
免责声明:如果侵犯了您的权益,请联系站长,我们会及时删除侵权内容,谢谢合作!
页: [1]
查看完整版本: Solon StateMachine 实现状态机使用示例详解