架构与系统设计 / 系统课时
领域对象划分
领域对象划分
本课把支付平台中容易混在一起的订单、金额、状态与计算规则拆成清晰的领域对象,并通过一个可运行示例建立实体、值对象、聚合和领域服务之间的边界。
学习目标
- 能根据身份、属性和生命周期区分实体与值对象
- 能围绕一致性边界设计聚合与聚合根
- 能判断一段业务逻辑是否应放入领域服务
从业务不变量开始划分
领域对象不是按数据库表数量机械拆分,而是围绕业务不变量组织。支付订单必须拥有稳定身份,金额必须同时包含数值和币种,支付成功后不能再次回到待支付状态,这些约束决定了对象边界。
实体关心“是不是同一个对象”。即使订单状态、支付方式或完成时间发生变化,只要订单标识没有改变,它仍是同一笔支付订单。
值对象关心“值是否相等”。金额、币种、商户订单号等对象通常没有独立生命周期,只要内部值相同,就可以视为同一个业务含义。
聚合保护一致性边界
聚合是一组需要在同一次业务操作中保持一致的对象,聚合根是外部修改这组对象的唯一入口。支付订单适合作为聚合根,因为状态迁移、金额校验和支付结果写入都必须由订单统一控制。

外部代码不应直接修改订单内部字段,而应调用 markPaid、cancel 等表达业务意图的方法。这样可以把状态转换条件集中在聚合根中,避免控制器、服务类和数据库脚本各自维护一套规则。
领域服务承载跨对象规则
当一段业务规则不自然地属于某个实体或值对象,又确实是领域知识时,可以放入领域服务。例如手续费计算依赖订单金额和费率,但它既不是金额自身的职责,也不是订单状态变化的一部分。
领域服务应保持无状态,输入领域对象,输出领域结果。若一个“服务”主要负责调用数据库、发送消息或拼装接口参数,它更可能是应用服务或基础设施服务,而不是领域服务。
可运行示例
下面的 Java 示例把支付订单建模为实体和聚合根,把金额建模为值对象,并用领域服务计算手续费。
import java.math.BigDecimal;
import java.math.RoundingMode;
public class DomainModelDemo {
enum PaymentStatus {
CREATED, PAID
}
record Money(BigDecimal amount, String currency) {
Money {
if (amount == null || amount.signum() < 0) {
throw new IllegalArgumentException("amount must be non-negative");
}
if (currency == null || currency.length() != 3) {
throw new IllegalArgumentException("currency must be a 3-letter code");
}
amount = amount.setScale(2, RoundingMode.HALF_UP);
}
@Override
public String toString() {
return amount + " " + currency;
}
}
static final class PaymentOrder {
private final String orderId;
private final String merchantOrderNo;
private final Money amount;
private PaymentStatus status = PaymentStatus.CREATED;
PaymentOrder(String orderId, String merchantOrderNo, Money amount) {
this.orderId = orderId;
this.merchantOrderNo = merchantOrderNo;
this.amount = amount;
}
void markPaid() {
if (status != PaymentStatus.CREATED) {
throw new IllegalStateException("only created order can be paid");
}
status = PaymentStatus.PAID;
}
String orderId() {
return orderId;
}
PaymentStatus status() {
return status;
}
Money amount() {
return amount;
}
}
static final class FeeCalculator {
Money calculate(Money amount, BigDecimal rate) {
BigDecimal fee = amount.amount()
.multiply(rate)
.setScale(2, RoundingMode.HALF_UP);
return new Money(fee, amount.currency());
}
}
public static void main(String[] args) {
PaymentOrder order = new PaymentOrder(
"PAY-1001",
"MER-20260803-001",
new Money(new BigDecimal("100.00"), "CNY")
);
Money fee = new FeeCalculator()
.calculate(order.amount(), new BigDecimal("0.0100"));
order.markPaid();
System.out.println("orderId=" + order.orderId());
System.out.println("status=" + order.status());
System.out.println("fee=" + fee);
}
}预期输出:
orderId=PAY-1001
status=PAID
fee=1.00 CNY示例中,PaymentOrder 通过身份区分实例,Money 通过全部字段比较值,markPaid 保护状态不变量,FeeCalculator 只负责跨对象的手续费规则。
容易混淆的边界
数据库表不等于聚合。一个聚合可以落在多张表中,多种聚合也可能共享同一张宽表。聚合边界应由事务一致性决定,而不是由外键数量决定。
应用服务负责组织一次用例,例如加载订单、调用 markPaid、保存订单并发布事件;领域对象负责表达规则;仓储负责持久化。三者职责分开后,业务规则更容易测试和复用。