当前位置：首页 > news >正文

Java中的状态机实现：使用Spring State Machine管理复杂状态流转

news 2026/4/1 3:17:57

在软件开发中，我们经常会遇到需要处理各种状态以及状态之间转换的场景。这些状态转换有时会变得非常复杂，特别是当涉及到多个状态，并且每个状态都有多个可能的触发事件导致不同的状态变化时。手动编写这样的逻辑不仅容易出错，而且难以维护。这时，引入状态机的概念可以帮助我们更清晰地管理这些状态及其转换。本文将探讨如何利用Spring State Machine来实现这样一个状态机，并通过一个实际的业务场景来展示其实现过程。

业务场景 - 订单处理流程

假设我们在开发一个电商平台的订单处理系统。从用户下单到最终订单完成，订单的状态需要经历以下几个阶段：

待支付（ORDER_PLACED）：订单创建后，等待用户支付。
已支付（PAID）：用户已经完成了支付。
已发货（SHIPPED）：商家已经发货。
已完成（COMPLETED）：用户确认收货。
已取消（CANCELLED）：订单被取消。

在这个过程中，我们需要定义每个状态之间的合法转换，并且为某些状态转换添加额外的逻辑，例如，在订单从“待支付”转变为“已支付”时，我们需要检查支付信息是否正确。

使用Spring State Machine实现状态机

Spring State Machine是Spring Framework的一部分，提供了一个简单的方式来实现状态机。它支持有限状态机（FSM），并提供了许多特性来简化状态机的配置和使用。

步骤 1: 添加依赖

首先，我们需要在项目中添加Spring State Machine的依赖。如果你使用的是Maven，可以在pom.xml文件中添加以下依赖：

xml

深色版本

<dependency><groupId>org.springframework.statemachine</groupId><artifactId>spring-statemachine-core</artifactId><version>3.0.0</version>
</dependency>

步骤 2: 定义状态与转换

接下来，定义订单处理流程中的所有状态，并设置状态之间的转换规则。

java

深色版本

@Configuration
@EnableStateMachineFactory
public class OrderStateMachineConfig extends EnumStateMachineConfigurerAdapter<OrderState, OrderEvent> {@Overridepublic void configure(StateMachineConfigurationConfigurer<OrderState, OrderEvent> config) throws Exception {config.withConfiguration().autoStartup(true);}@Overridepublic void configure(StateMachineStateConfigurer<OrderState, OrderEvent> states) throws Exception {states.withStates().initial(OrderState.ORDER_PLACED).states(EnumSet.allOf(OrderState.class));}@Overridepublic void configure(StateMachineTransitionConfigurer<OrderState, OrderEvent> transitions) throws Exception {transitions.withExternal().source(OrderState.ORDER_PLACED).target(OrderState.PAID).event(OrderEvent.PAYMENT_RECEIVED).and().withExternal().source(OrderState.PAID).target(OrderState.SHIPPED).event(OrderEvent.SHIPMENT_REQUESTED).and().withExternal().source(OrderState.SHIPPED).target(OrderState.COMPLETED).event(OrderEvent.DELIVERY_CONFIRMED).and().withExternal().source(OrderState.ORDER_PLACED).target(OrderState.CANCELLED).event(OrderEvent.CANCELLATION_REQUESTED).and().withExternal().source(OrderState.PAID).target(OrderState.CANCELLED).event(OrderEvent.CANCELLATION_REQUESTED);}
}

步骤 3: 触发状态转换

在业务逻辑中，当某个条件满足时，可以触发状态转换。例如，在处理支付成功的事件时，可以通过如下方式触发状态转换：

java

深色版本

@Autowired
private StateMachine<OrderState, OrderEvent> stateMachine;public void handlePaymentReceived() {stateMachine.sendEvent(OrderEvent.PAYMENT_RECEIVED);
}

步骤 4: 监听状态变化

最后，我们可以添加监听器来监听状态的变化，并执行相应的操作。例如，在订单状态从“已支付”变为“已发货”时，我们可以发送一条通知给用户。

java

深色版本

@Bean
public StateMachineListener<OrderState, OrderEvent> listener() {return new StateMachineListenerAdapter<OrderState, OrderEvent>() {@Overridepublic void stateChanged(State<OrderState, OrderEvent> from, State<OrderState, OrderEvent> to) {if (to.getId().equals(OrderState.SHIPPED)) {// 发送通知给用户}}};
}@Override
public void configure(StateMachineListenersConfigurer<OrderState, OrderEvent> listeners) throws Exception {listeners.withListeners().listener(listener());
}

以上就是使用Spring State Machine实现状态机的一个基本过程。通过这种方式，我们可以更加清晰地管理和控制应用程序中的状态转换逻辑。