当前位置:

首页 > 编程开发 > Java中状态机模式的两种实现方式详解

Java中状态机模式的两种实现方式详解

一、什么是状态机 先说说状态机这个概念。它本质上是一个数学模型,用来描述一个对象在其生命周期里,会经历哪些状态,以及在什么条件下从一个状态跳到另一个状态。说白了,就是给对象画一张“状态流转地图”。 理解状态机,抓住三个核心要素就够了: 状态(State):对象当前处于什么情形。比如订单是“待支付”还

本文目录

    一、什么是状态机

    先说说状态机这个概念。它本质上是一个数学模型,用来描述一个对象在其生命周期里,会经历哪些状态,以及在什么条件下从一个状态跳到另一个状态。说白了,就是给对象画一张“状态流转地图”。

    Ja va中状态机模式的两种实现方式详解

    理解状态机,抓住三个核心要素就够了:

    • 状态(State):对象当前处于什么情形。比如订单是“待支付”还是“已发货”。
    • 事件(Event):触发状态变化的动作或条件。比如用户点击了“支付”按钮。
    • 转换(Transition):从一个状态到另一个状态的过程。比如“待支付”遇到“支付”事件,就变成“已支付”。

    用一句话概括:在某个状态下,发生了某个事件,对象转换到了另一个状态。就这么简单。

    二、状态机的两种实现方式

    1. 显式状态机

    显式状态机,就是通过独立的状态机框架或代码结构来管理状态转换。所有状态流转规则都集中定义、显式声明,一目了然。

    特点:

    • 状态和转换规则集中配置
    • 有明确的状态转换表或图
    • 非法转换会被统一拦截
    • 通常有框架支持(如 Spring StateMachine)

    2. 隐式状态机

    隐式状态机则相反——没有独立的状态机组件,状态值就存在数据库的一个字段里,流转逻辑分散在各个业务方法的 if/else 或 switch 中。你看代码的时候,得一个一个方法去翻,才知道哪些状态能转到哪些状态。

    特点:

    • 状态就是一个普通字段
    • 转换逻辑散落在各处业务代码中
    • 没有统一的规则校验
    • 实现简单,但维护成本会随着业务增长而直线上升

    三、隐式状态机的典型实现方式

    这是大多数业务系统中最常见的做法。用一个订单状态的例子来说明:

    数据库层面

    CREATE TABLE orders (
        id INT PRIMARY KEY,
        status INT NOT NULL DEFAULT 0 COMMENT '0=待支付, 1=已支付, 2=已发货, 3=已完成, 4=已取消'
    );

    枚举定义

    public enum OrderStatus {
        UNPAID(0, "待支付"),
        PAID(1, "已支付"),
        SHIPPED(2, "已发货"),
        COMPLETED(3, "已完成"),
        CANCELLED(4, "已取消");
    
        private Integer code;
        private String desc;
    }
    

    业务代码中的状态流转

    public void payOrder(Integer orderId) {
        Order order = orderRepository.findById(orderId);
        // 隐式校验:只有待支付才能支付
        if (!OrderStatus.UNPAID.getCode().equals(order.getStatus())) {
            throw new BusinessException("当前状态不允许支付");
        }
        order.setStatus(OrderStatus.PAID.getCode());
        orderRepository.sa ve(order);
    }
    
    public void shipOrder(Integer orderId) {
        Order order = orderRepository.findById(orderId);
        // 隐式校验:只有已支付才能发货
        if (!OrderStatus.PAID.getCode().equals(order.getStatus())) {
            throw new BusinessException("当前状态不允许发货");
        }
        order.setStatus(OrderStatus.SHIPPED.getCode());
        orderRepository.sa ve(order);
    }
    
    public void cancelOrder(Integer orderId) {
        Order order = orderRepository.findById(orderId);
        // 隐式校验:已发货和已完成不能取消
        if (OrderStatus.SHIPPED.getCode().equals(order.getStatus())
            || OrderStatus.COMPLETED.getCode().equals(order.getStatus())) {
            throw new BusinessException("当前状态不允许取消");
        }
        order.setStatus(OrderStatus.CANCELLED.getCode());
        orderRepository.sa ve(order);
    }
    

    状态转换图:

    UNPAID(0) ──[支付]──→ PAID(1) ──[发货]──→ SHIPPED(2) ──[确认收货]──→ COMPLETED(3)

    │ │

    └──[取消]──→ CANCELLED(4) ←──[取消]──┘

    这就是隐式状态机——没有一个集中的地方定义“什么状态可以转到什么状态”,全靠每个业务方法里的 if 判断来保证。状态少的时候还能凑合,一旦状态多了,维护起来就头疼了。

    四、显式状态机的实现方式

    方式一:状态转换表

    把所有合法的转换关系集中定义在一张表里,代码瞬间清晰:

    public class OrderStateMachine {
    
        // 转换规则表:Map<当前状态, Map<事件, 目标状态>>
        private static final Map> TRANSITIONS = new HashMap<>();
    
        static {
            // 待支付状态下的合法转换
            Map unpaidTransitions = new HashMap<>();
            unpaidTransitions.put("PAY", 1);       // 支付 → 已支付
            unpaidTransitions.put("CANCEL", 4);    // 取消 → 已取消
            TRANSITIONS.put(0, unpaidTransitions);
    
            // 已支付状态下的合法转换
            Map paidTransitions = new HashMap<>();
            paidTransitions.put("SHIP", 2);        // 发货 → 已发货
            paidTransitions.put("CANCEL", 4);      // 取消 → 已取消
            TRANSITIONS.put(1, paidTransitions);
    
            // 已发货状态下的合法转换
            Map shippedTransitions = new HashMap<>();
            shippedTransitions.put("CONFIRM", 3);  // 确认 → 已完成
            TRANSITIONS.put(2, shippedTransitions);
        }
    
        /**
         * 执行状态转换.
         */
        public static Integer transition(Integer currentState, String event) {
            Map allowed = TRANSITIONS.get(currentState);
            if (allowed == null || !allowed.containsKey(event)) {
                throw new IllegalStateException(
                    "非法状态转换: 状态=" + currentState + ", 事件=" + event);
            }
            return allowed.get(event);
        }
    }
    

    使用起来也很简单:

    public void payOrder(Integer orderId) {
        Order order = orderRepository.findById(orderId);
        // 由状态机统一校验和转换
        Integer newStatus = OrderStateMachine.transition(order.getStatus(), "PAY");
        order.setStatus(newStatus);
        orderRepository.sa ve(order);
    }
    

    方式二:枚举 + 方法

    还有一种更优雅的方式——把状态转换逻辑直接写在枚举里:

    public enum OrderStatus {
        UNPAID(0) {
            @Override
            public OrderStatus onPay() { return PAID; }
            @Override
            public OrderStatus onCancel() { return CANCELLED; }
        },
        PAID(1) {
            @Override
            public OrderStatus onShip() { return SHIPPED; }
            @Override
            public OrderStatus onCancel() { return CANCELLED; }
        },
        SHIPPED(2) {
            @Override
            public OrderStatus onConfirm() { return COMPLETED; }
        },
        COMPLETED(3),
        CANCELLED(4);
    
        private Integer code;
    
        // 默认实现:抛异常表示不允许该操作
        public OrderStatus onPay() { throw new IllegalStateException("当前状态不允许支付"); }
        public OrderStatus onShip() { throw new IllegalStateException("当前状态不允许发货"); }
        public OrderStatus onConfirm() { throw new IllegalStateException("当前状态不允许确认"); }
        public OrderStatus onCancel() { throw new IllegalStateException("当前状态不允许取消"); }
    }
    

    这样每个状态自己就知道哪些操作是合法的,调用方不需要关心具体规则,直接调方法就行。

    五、两种方式的对比

    维度隐式状态机显式状态机
    实现成本低,直接写 if/else中等,需要定义转换规则
    可读性差,状态规则分散在各方法中好,规则集中一目了然
    维护成本状态少时低,状态多时急剧上升稳定,新增状态只需加规则
    安全性容易遗漏校验导致非法转换统一拦截非法转换
    适用场景状态少(3-5个)且变化少状态多或流转规则复杂

    从这张表可以看出来,选择哪种方式取决于你的业务复杂度。如果只有两三个状态,用隐式完全够用;一旦状态超过五个,或者转换规则频繁变动,显式状态机才是长久之计。

    六、状态机中的常见概念

    守卫条件(Guard)

    在实际业务中,状态转换往往不是“事件触发就转”这么简单,还需要额外的校验。比如,订单要发货,前提是库存充足。这种校验就叫守卫条件:

    // 事件是"发货",但还需要守卫条件:库存充足
    public Integer transition(Integer currentState, String event, Order order) {
        if ("SHIP".equals(event) && order.getStock() <= 0) {
            throw new BusinessException("库存不足,无法发货");
        }
        return TRANSITIONS.get(currentState).get(event);
    }
    

    转换动作(Action)

    状态转换时,通常还需要附带执行一些业务操作。比如订单取消时,要自动退款、发通知:

    // 转换到"已取消"时,自动执行退款
    public void cancelOrder(Order order) {
        Integer newStatus = OrderStateMachine.transition(order.getStatus(), "CANCEL");
        order.setStatus(newStatus);
        // 转换动作
        refundService.refund(order.getPaymentId());
        notificationService.notifyUser(order.getUserId(), "订单已取消");
    }
    

    入口动作 / 出口动作(Entry/Exit Action)

    有些动作与触发事件无关,只要进入某个状态就固定执行。比如无论从哪个状态进入“已取消”,都要发通知并释放库存:

    // 无论从哪里进入"已取消"状态,都发通知
    private void onEnterCancelled(Order order) {
        notificationService.notifyUser(order.getUserId(), "订单已取消");
        inventoryService.releaseStock(order.getItems());
    }
    

    状态回退(Rollback)

    有时候业务需要回退,比如物流拦截成功,需要从“已发货”回退到“已支付”。回退不只是改状态字段,还要撤销之前执行的动作:

    // 从已发货回退到已支付(例如物流拦截成功)
    public void rollbackShipment(Order order) {
        if (!OrderStatus.SHIPPED.getCode().equals(order.getStatus())) {
            throw new BusinessException("只有已发货状态才能回退");
        }
        order.setStatus(OrderStatus.PAID.getCode());
        // 撤销动作:取消物流单、恢复库存
        logisticsService.cancelShipment(order.getLogisticsNo());
        inventoryService.restoreStock(order.getItems());
    }
    

    七、涉及多字段联动的复合状态

    实际业务中,一个对象往往有多个状态维度,形成复合状态。比如一个订单既有“签章状态”,又有“同步状态”:

    // 两个独立的状态维度
    private Integer signStatus;    // 签章状态
    private Integer syncYcStatus;  // 同步状态
    
    // 复合状态:只有签章完成且已同步才算"流程结束"
    // 回退时两个维度可能都需要回退
    

    这种场景下,有几个关键点要特别注意:

    • 两个状态之间是否有依赖关系(比如同步必须在签章完成之后才能进行)
    • 回退时是否需要联动回退(签章回退了,同步状态是不是也要跟着回退)
    • 是否有外部系统已经接收了数据(如果是不可逆操作,比如已经发送给第三方,回退就要特别谨慎)

    八、总结

    状态机本质上解决的是对象生命周期管理的问题。不管用哪种方式实现,核心关注点就那么几个:

    1. 有哪些状态 → 用枚举定义清楚,别漏掉
    2. 什么事件触发什么转换 → 转换规则要集中管理,别散落在各处
    3. 转换时要做什么 → 把动作和转换绑定,别漏掉重要的业务操作
    4. 非法转换怎么办 → 统一校验拦截,别等出bug了再补
    5. 需要回退怎么办 → 设计好逆向转换和补偿动作,别让回退变成新的麻烦

    把这五点想清楚,状态机这关就算过了。

    本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系bd@zhengruan.com
    作者最新文章
    编程开发
    相关文章 更多
    Claude Code 2.1.325哪些权限默认值变了,自动任务如何适配?
    Claude Code 2.1.325哪些权限默认值变了,自动任务如何适配?

    Claude Code 2.1.325改变了两类自动执行的默认行为:沙箱内Bash默认走常规权限流程,定时任务及/loop执行带allowed-tools或hooks声明的Skill会先请求确认。官方提供了对应配置,但受管环境必须遵守最高优先级的管理来源。

    Perplexity Decider v1.3与Decider Flash v1.3怎样选择,locate适合哪些任务
    Perplexity Decider v1.3与Decider Flash v1.3怎样选择,locate适合哪些任务

    Decider v1.3面向细致判断,Flash v1.3面向高量路由与过滤;locate抽取原文片段及位置,需与分类、多模态和托管入口限制分开理解。

    Transformers 5.23.0对导出、音频和专家并行环境有哪些兼容边界?
    Transformers 5.23.0对导出、音频和专家并行环境有哪些兼容边界?

    5.23.0影响范围取决于旧导出对象、音频依赖与专家并行路径,新增模型也有实验和变体限制。

    GitHub Copilot模型停用后会自动替换吗,哪些事情仍需提前确认?
    GitHub Copilot模型停用后会自动替换吗,哪些事情仍需提前确认?

    Copilot停用旧模型不等于自动迁移;区分移除、组织模型启用、工作流切换与个人年订阅例外。

    GitHub Actions重跑失败作业会使用最新代码吗
    GitHub Actions重跑失败作业会使用最新代码吗

    解释已有运行重跑的提交和权限边界,给出确认、失败作业重跑及结果核对命令,区分漏触发事件。

    chat-demo v0.1.1怎么本地运行并理解DeepSeek历史数据边界
    chat-demo v0.1.1怎么本地运行并理解DeepSeek历史数据边界

    chat-demo v0.1.1可以作为静态聊天客户端在本地运行,但模型、搜索、文件和语音能力仍由DeepSeek API提供。源码运行环境为Node.js 22.12及以上、Git与pnpm。Demo版本号不等于应用API版本;这套应用API未单独标版本,默认聊天模型ID是deepseek-flash。

    GitHub Copilot CLI v1.0.111的用量图与上下文比例应该怎样理解
    GitHub Copilot CLI v1.0.111的用量图与上下文比例应该怎样理解

    理解GitHub Copilot CLI v1.0.111的高级请求百分比、用户提示活动图与实际路由模型窗口,区分显示口径和任务状态。

    n8n 2.47.6、2.47.7、2.48.3 Beta、2.48.4 Beta、3.2.2预发布与1.123.96适用哪些安全修复?
    n8n 2.47.6、2.47.7、2.48.3 Beta、2.48.4 Beta、3.2.2预发布与1.123.96适用哪些安全修复?

    按维护分支、利用权限与节点类型对应四项修复,区分正式补丁、Beta和临时缓解的适用边界。

    GitHub合并故障的已缓解、监控与已解决有什么不同
    GitHub合并故障的已缓解、监控与已解决有什么不同

    GitHub合并故障中的“已缓解并监控”和“已解决”不能互换。前者表示影响已经采取措施缓解,仍在观察稳定性;后者是供应商正式结束这场事故的状态。11月13日的Pull Requests合并超时事件先进入监控,随后于北京时间11月14日02:29标记为已解决。

    llama.cpp v1.0.0的网页聊天分组与Markdown编辑适合哪些场景
    llama.cpp v1.0.0的网页聊天分组与Markdown编辑适合哪些场景

    llama.cpp v1.0.0改善聊天组织、长消息编辑和附件预览;界面变化与底层API迁移、缓存及访问边界需要分别理解。

    查看更多
    精品专题 更多
    装机必备
    装机必备

    正软商城装机必备专区,精选办公、浏览器、安全防护、影音播放、压缩解压、设计创作和系统工具等电脑常用正版软件,帮助用户快速完成新电脑软件配置。

    Windows
    Windows

    正软商城Windows软件专区,汇集适用于Windows电脑的办公、设计、安全防护、影音播放、开发工具和系统优化软件,提供软件介绍、系统要求、正版授权及购买下载服务。

    PDF教程
    PDF教程

    正软商城PDF教程频道提供PDF编辑、转换、合并、拆分、压缩及格式处理方法,同时介绍常用PDF软件和工具的使用技巧。

    Mac软件 更多
    讯飞智作 网页版
    讯飞智作 网页版
    Windows/ macOS/ Linux

    讯飞智作是一款基于语音合成技术、虚拟人驱动技术与数字人形象声音构建能力的 AI 数字人音视频创作平台。

    火山引擎 网页版
    火山引擎 网页版
    Windows/ macOS/ Linux

    火山引擎是字节跳动旗下企业级云与AI服务平台。聚焦大模型核心能力,依托字节自研豆包多模态大模型,凭借火山方舟一站式平台,提供模型精调、推理部署、智能应用搭建等全链路服务,结合高性能AI算力,助力各行业快速落地大模型数字化与智能化应用。

    Aperty macOS版
    Aperty macOS版
    macOS

    Aperty 是 Skylum 推出的 AI 人像修图软件,支持自然肤质修饰、瑕疵处理、面部与身体调整、预设及批量同步。

    WINDOWS 更多
    讯飞智作 网页版
    讯飞智作 网页版
    Windows/ macOS/ Linux

    讯飞智作是一款基于语音合成技术、虚拟人驱动技术与数字人形象声音构建能力的 AI 数字人音视频创作平台。

    火山引擎 网页版
    火山引擎 网页版
    Windows/ macOS/ Linux

    火山引擎是字节跳动旗下企业级云与AI服务平台。聚焦大模型核心能力,依托字节自研豆包多模态大模型,凭借火山方舟一站式平台,提供模型精调、推理部署、智能应用搭建等全链路服务,结合高性能AI算力,助力各行业快速落地大模型数字化与智能化应用。

    PixTV 网页版
    PixTV 网页版
    Windows

    PixTV 是一款在浏览器中使用的 AI 视觉内容创作平台,提供图片、视频、音频、文字生成、AI 分镜、局部重绘、提示词反推和无限画布等工具,适合短剧、漫剧、广告及社交媒体内容制作。