架构与系统设计 / 系统课时
什么业务逻辑应该优先放回实体
什么业务逻辑应该优先放回实体
领域服务很容易变成“所有业务判断都往里放”的容器。判断逻辑是否应该回到实体,关键不是代码长短,而是它是否在维护实体自己的状态和不变量。本篇用状态转换与金额校验说明如何把行为放回最自然的业务对象。
学习目标
- 判断一条规则是否属于实体自身职责
- 区分实体行为、值对象行为与领域服务
- 避免把实体写成只有 getter 和 setter 的贫血模型
先看规则在保护谁的不变量
如果一条规则主要读取并修改某个实体自己的状态,而且调用者一旦绕过这条规则就可能制造非法状态,那么它通常应该成为实体方法。
例如订单从“已创建”变成“已支付”时,需要同时保证订单当前仍可支付、支付金额与订单金额一致。把这些判断放在 Order.pay 内部,比让应用服务先检查再调用 setter 更可靠,因为任何调用方都必须经过同一个入口。
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());
}
}
}预期输出:
PAID
Only CREATED orders can be paid这个设计让“不能重复支付”成为 Order 自己的不变量,而不是依赖每个应用服务都记得先做检查。
金额规则优先靠近值对象或实体
金额加减、币种一致性、精度约束,如果只依赖金额本身,通常属于 Money 这类值对象。订单总价、折扣后金额或退款上限,如果需要订单行、订单状态等实体内部信息,则更适合由订单实体计算。
可以用一个简单问题判断:如果把这段计算移出对象,调用者是否必须先读取对象内部多个字段,再重新拼出同样规则? 如果答案是“是”,通常说明行为应该回到对象内部。
什么时候才需要领域服务
领域服务适合没有自然单一归属者的业务规则,例如规则同时涉及两个不同聚合,或者需要比较多个领域对象才能得出结论。它不应该成为“实体之外的默认放置点”。
| 规则特征 | 更合适的位置 |
|---|---|
| 维护一个实体的合法状态转换 | 实体 |
| 只依赖值本身完成计算或校验 | 值对象 |
| 跨多个聚合且没有自然拥有者 | 领域服务 |
| 查询编排、事务、发送消息 | 应用层 |
如果一个领域服务的方法只是读取某个实体的一堆 getter、判断状态,再调用多个 setter,优先考虑把这组行为收回实体。这样可以减少“先查状态、后修改状态”之间被绕过的机会。
用所有权而不是代码量做判断
“逻辑很复杂”并不是放进领域服务的理由。复杂但明显属于订单生命周期的规则,仍然应该由订单拥有;很短但跨两个聚合的规则,也可能更适合领域服务。
最终判断可以收敛为一句话:谁拥有这条业务不变量,谁就应该尽量拥有实现它的行为。实体因此不仅保存数据,还负责拒绝不合法的状态变化;领域服务则只处理那些确实找不到单一对象作为自然归属者的规则。