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

领域对象划分

领域对象划分

本课把支付平台中容易混在一起的订单、金额、状态与计算规则拆成清晰的领域对象,并通过一个可运行示例建立实体、值对象、聚合和领域服务之间的边界。

学习目标

  • 能根据身份、属性和生命周期区分实体与值对象
  • 能围绕一致性边界设计聚合与聚合根
  • 能判断一段业务逻辑是否应放入领域服务

从业务不变量开始划分

领域对象不是按数据库表数量机械拆分,而是围绕业务不变量组织。支付订单必须拥有稳定身份,金额必须同时包含数值和币种,支付成功后不能再次回到待支付状态,这些约束决定了对象边界。

实体关心“是不是同一个对象”。即使订单状态、支付方式或完成时间发生变化,只要订单标识没有改变,它仍是同一笔支付订单。

值对象关心“值是否相等”。金额、币种、商户订单号等对象通常没有独立生命周期,只要内部值相同,就可以视为同一个业务含义。

聚合保护一致性边界

聚合是一组需要在同一次业务操作中保持一致的对象,聚合根是外部修改这组对象的唯一入口。支付订单适合作为聚合根,因为状态迁移、金额校验和支付结果写入都必须由订单统一控制。

支付领域对象关系图

外部代码不应直接修改订单内部字段,而应调用 markPaid、cancel 等表达业务意图的方法。这样可以把状态转换条件集中在聚合根中,避免控制器、服务类和数据库脚本各自维护一套规则。

领域服务承载跨对象规则

当一段业务规则不自然地属于某个实体或值对象,又确实是领域知识时,可以放入领域服务。例如手续费计算依赖订单金额和费率,但它既不是金额自身的职责,也不是订单状态变化的一部分。

领域服务应保持无状态,输入领域对象,输出领域结果。若一个“服务”主要负责调用数据库、发送消息或拼装接口参数,它更可能是应用服务或基础设施服务,而不是领域服务。

可运行示例

下面的 Java 示例把支付订单建模为实体和聚合根,把金额建模为值对象,并用领域服务计算手续费。

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);
    }
}

预期输出:

text
orderId=PAY-1001
status=PAID
fee=1.00 CNY

示例中,PaymentOrder 通过身份区分实例,Money 通过全部字段比较值,markPaid 保护状态不变量,FeeCalculator 只负责跨对象的手续费规则。

容易混淆的边界

数据库表不等于聚合。一个聚合可以落在多张表中,多种聚合也可能共享同一张宽表。聚合边界应由事务一致性决定,而不是由外键数量决定。

应用服务负责组织一次用例,例如加载订单、调用 markPaid、保存订单并发布事件;领域对象负责表达规则;仓储负责持久化。三者职责分开后,业务规则更容易测试和复用。

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

目录与阅读设置

阅读设置

17

记录一个想法

领域对象划分

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

登录哪都通