架构与系统设计 / 系统课时

实体的方法应该写什么

实体的方法应该写什么

实体的方法不应只是给字段换个名字的 setter,而应把“什么状态下允许做什么”写成业务行为。下面用订单支付、发货和取消说明:实体如何在修改自身状态前检查规则,并保证任何一次调用都不会把对象推进到非法状态。

学习目标

  • 判断哪些业务规则应该进入实体方法
  • 用状态转换保护实体自身的不变量
  • 区分实体行为与应用服务的职责

实体方法的核心是维护不变量

实体拥有身份,也拥有一组必须始终成立的业务约束。所谓不变量,就是无论从哪个入口操作对象,规则都不能被绕过。例如订单已经发货后不能取消,未支付的订单不能直接发货。

因此,实体方法应该优先表达业务动作,如 pay()、ship()、cancel(),而不是暴露 setStatus() 让外部任意写状态。方法内部先检查当前状态和必要条件,只有规则成立才修改数据;失败时立即拒绝操作。

适合放进实体的方法通常具有三个特征:规则主要依赖实体自己的状态或值对象;违反规则会让实体进入非法状态;动作能用领域语言自然命名。反过来,查询数据库、调用支付网关、发送消息等外部协作不属于实体自身职责。

用订单状态变化保护规则

订单的核心状态可以简化为 CREATED、PAID、SHIPPED 和 CANCELED。合法转换并不是任意组合,而是由业务动作决定。

订单实体状态转换图

下面的完整 Java 示例把这些转换直接封装在实体中。外部代码只能调用业务方法,无法直接改写状态。

java
public class OrderEntityDemo {
    enum Status {
        CREATED, PAID, SHIPPED, CANCELED
    }

    static final class Order {
        private final String orderId;
        private Status status = Status.CREATED;

        Order(String orderId) {
            if (orderId == null || orderId.isBlank()) {
                throw new IllegalArgumentException("订单号不能为空");
            }
            this.orderId = orderId;
        }

        void pay() {
            // 支付只允许从已创建状态进入已支付状态。
            if (status != Status.CREATED) {
                throw new IllegalStateException("只有待支付订单可以支付");
            }
            status = Status.PAID;
        }

        void ship() {
            // 发货依赖订单已经完成支付这一业务前置条件。
            if (status != Status.PAID) {
                throw new IllegalStateException("只有已支付订单可以发货");
            }
            status = Status.SHIPPED;
        }

        void cancel() {
            // 已发货订单一旦取消会破坏订单生命周期约束,因此直接拒绝。
            if (status == Status.SHIPPED) {
                throw new IllegalStateException("已发货订单不能取消");
            }
            if (status == Status.CANCELED) {
                throw new IllegalStateException("订单已经取消");
            }
            status = Status.CANCELED;
        }

        Status status() {
            return status;
        }
    }

    public static void main(String[] args) {
        Order order = new Order("O-1001");
        order.pay();
        order.ship();

        System.out.println("状态: " + order.status());

        try {
            order.cancel();
        } catch (IllegalStateException e) {
            System.out.println("拒绝取消: " + e.getMessage());
        }
    }
}

预期输出

text
状态: SHIPPED
拒绝取消: 已发货订单不能取消

这里最重要的不是使用枚举,而是任何调用方都必须经过实体定义的合法入口。即使以后接口、定时任务和消息消费者都能操作订单,也不能绕过同一组规则。

判断方法该不该放进实体

可以按下面的顺序判断一个行为是否应该由实体承担:

  1. 这个行为是否会改变实体自身状态,或依赖实体当前状态做判断。
  2. 如果绕过这个行为,是否可能得到业务上不合法的实体。
  3. 这个行为是否主要依赖实体内部信息,而不是多个聚合、远程服务或数据库查询。

例如“订单发货前必须已支付”应由订单实体保护;“调用物流服务创建运单”则需要外部系统参与,通常由应用服务组织。应用服务可以先加载订单、调用 order.ship(),再保存订单并触发后续集成操作。

避免把所有逻辑都塞进实体

“富领域模型”不等于“实体知道一切”。实体负责本聚合内部的一致性和业务行为,应用层负责流程编排,仓储和外部服务负责持久化与集成。把边界守住后,实体的方法会更像业务语言,同时也更容易测试:只需构造对象并调用方法,就能验证规则是否被正确保护。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

实体的方法应该写什么

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通