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

什么业务逻辑应该优先放回实体

什么业务逻辑应该优先放回实体

领域服务很容易变成“所有业务判断都往里放”的容器。判断逻辑是否应该回到实体,关键不是代码长短,而是它是否在维护实体自己的状态和不变量。本篇用状态转换与金额校验说明如何把行为放回最自然的业务对象。

学习目标

  • 判断一条规则是否属于实体自身职责
  • 区分实体行为、值对象行为与领域服务
  • 避免把实体写成只有 getter 和 setter 的贫血模型

先看规则在保护谁的不变量

如果一条规则主要读取并修改某个实体自己的状态,而且调用者一旦绕过这条规则就可能制造非法状态,那么它通常应该成为实体方法。

例如订单从“已创建”变成“已支付”时,需要同时保证订单当前仍可支付、支付金额与订单金额一致。把这些判断放在 Order.pay 内部,比让应用服务先检查再调用 setter 更可靠,因为任何调用方都必须经过同一个入口。

java
import java.math.BigDecimal;

public class Main {
    enum OrderStatus {
        CREATED, PAID, CANCELLED
    }

    record Money(BigDecimal amount, String currency) {
        Money {
            if (amount.signum() < 0) {
                throw new IllegalArgumentException("Amount cannot be negative");
            }
        }

        boolean sameValueAs(Money other) {
            return currency.equals(other.currency)
                    && amount.compareTo(other.amount) == 0;
        }
    }

    static class Order {
        private final Money total;
        private OrderStatus status = OrderStatus.CREATED;

        Order(Money total) {
            this.total = total;
        }

        void pay(Money paid) {
            if (status != OrderStatus.CREATED) {
                throw new IllegalStateException("Only CREATED orders can be paid");
            }
            if (!total.sameValueAs(paid)) {
                throw new IllegalArgumentException("Payment amount does not match order total");
            }
            status = OrderStatus.PAID;
        }

        OrderStatus status() {
            return status;
        }
    }

    public static void main(String[] args) {
        var order = new Order(new Money(new BigDecimal("199.00"), "MYR"));
        order.pay(new Money(new BigDecimal("199.00"), "MYR"));
        System.out.println(order.status());

        try {
            order.pay(new Money(new BigDecimal("199.00"), "MYR"));
        } catch (IllegalStateException e) {
            System.out.println(e.getMessage());
        }
    }
}

预期输出:

text
PAID
Only CREATED orders can be paid

这个设计让“不能重复支付”成为 Order 自己的不变量,而不是依赖每个应用服务都记得先做检查。

金额规则优先靠近值对象或实体

金额加减、币种一致性、精度约束,如果只依赖金额本身,通常属于 Money 这类值对象。订单总价、折扣后金额或退款上限,如果需要订单行、订单状态等实体内部信息,则更适合由订单实体计算。

可以用一个简单问题判断:如果把这段计算移出对象,调用者是否必须先读取对象内部多个字段,再重新拼出同样规则? 如果答案是“是”,通常说明行为应该回到对象内部。

什么时候才需要领域服务

领域服务适合没有自然单一归属者的业务规则,例如规则同时涉及两个不同聚合,或者需要比较多个领域对象才能得出结论。它不应该成为“实体之外的默认放置点”。

规则特征 更合适的位置
维护一个实体的合法状态转换 实体
只依赖值本身完成计算或校验 值对象
跨多个聚合且没有自然拥有者 领域服务
查询编排、事务、发送消息 应用层

如果一个领域服务的方法只是读取某个实体的一堆 getter、判断状态,再调用多个 setter,优先考虑把这组行为收回实体。这样可以减少“先查状态、后修改状态”之间被绕过的机会。

用所有权而不是代码量做判断

“逻辑很复杂”并不是放进领域服务的理由。复杂但明显属于订单生命周期的规则,仍然应该由订单拥有;很短但跨两个聚合的规则,也可能更适合领域服务。

最终判断可以收敛为一句话:谁拥有这条业务不变量,谁就应该尽量拥有实现它的行为。实体因此不仅保存数据,还负责拒绝不合法的状态变化;领域服务则只处理那些确实找不到单一对象作为自然归属者的规则。

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

目录与阅读设置

阅读设置

17

记录一个想法

什么业务逻辑应该优先放回实体

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

登录哪都通