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

Money 为什么适合做值对象

Money 为什么适合做值对象

如果业务把金额直接表示成 BigDecimal,加减法虽然简单,却很容易遗漏币种匹配、非负约束等规则。把“数值 + 币种 + 运算规则”封装成 Money 值对象,可以让这些约束在模型内部统一生效。

学习目标

  • 理解 Money 为什么应同时包含金额和币种
  • 使用值对象封装加减法与币种一致性规则
  • 区分领域约束与界面格式化等展示职责

金额不是一个裸数字

业务中的“100”本身通常没有完整意义。100 CNY、100 USD 和 100 JPY 是不同的金额,不能因为数值相同就视为相同,也不能直接相加。

因此,一个最小可用的 Money 至少需要两个组成值:金额 amount 和币种 currency。Money 的相等性由这些值共同决定,而不是由独立 ID 决定。两个 100 CNY 在领域语义上可以视为相等,即使它们是在不同时间创建的两个对象。

把币种放进 Money 还有一个重要作用:运算规则可以由对象自己保护。调用方不需要每次计算前都重复检查币种,遗漏检查的机会也随之减少。

把不变量放进值对象

下面的 Java 示例定义了一个不可变的 Money。示例业务约定金额不能为负数,同币种才能执行加减法,减法结果也不能小于零。不同领域允许的规则可能不同,例如会计调整额可能允许负值,因此这些约束应来自具体业务,而不是照搬为所有系统的通用规则。

java
import java.math.BigDecimal;
import java.util.Objects;

public class MoneyDemo {
    public record Money(BigDecimal amount, String currency) {
        public Money {
            Objects.requireNonNull(amount, "amount must not be null");
            Objects.requireNonNull(currency, "currency must not be null");

            if (amount.compareTo(BigDecimal.ZERO) < 0) {
                throw new IllegalArgumentException("amount must be non-negative");
            }
            if (currency.isBlank()) {
                throw new IllegalArgumentException("currency must not be blank");
            }

            // 统一数值表示,使 10.0 与 10.00 具有相同的值语义。
            amount = amount.stripTrailingZeros();
        }

        public Money add(Money other) {
            requireSameCurrency(other);
            return new Money(amount.add(other.amount), currency);
        }

        public Money subtract(Money other) {
            requireSameCurrency(other);
            return new Money(amount.subtract(other.amount), currency);
        }

        private void requireSameCurrency(Money other) {
            Objects.requireNonNull(other, "other must not be null");
            if (!currency.equals(other.currency)) {
                throw new IllegalArgumentException("currency mismatch");
            }
        }

        @Override
        public String toString() {
            return amount.toPlainString() + " " + currency;
        }
    }

    public static void main(String[] args) {
        Money price = new Money(new BigDecimal("10.00"), "CNY");
        Money shipping = new Money(new BigDecimal("5.50"), "CNY");

        System.out.println(price.add(shipping));
        System.out.println(shipping.subtract(new Money(new BigDecimal("3.50"), "CNY")));

        try {
            price.add(new Money(new BigDecimal("1.00"), "USD"));
        } catch (IllegalArgumentException e) {
            System.out.println(e.getMessage());
        }

        try {
            new Money(new BigDecimal("-1.00"), "CNY");
        } catch (IllegalArgumentException e) {
            System.out.println(e.getMessage());
        }
    }
}

预期输出

text
15.5 CNY
2 CNY
currency mismatch
amount must be non-negative

stripTrailingZeros() 在这里用于统一数值表示,因此输出不会固定保留两位小数。把 15.5 显示成 ¥15.50 属于格式化与本地化职责,可以在展示层完成,不应为了界面格式破坏 Money 的领域语义。

封装运算比封装字段更重要

如果 Money 只是把 BigDecimal 和币种放进一个类,却让调用方取出金额后自行计算,它只能减少参数数量,并没有真正保护业务规则。值对象更重要的价值,是把合法操作和不变量放在一起。

例如 add 先确认币种一致,再返回新的 Money,而不是修改当前实例;subtract 同样返回新对象,并通过构造过程再次执行非负检查。这样无论 Money 从哪个业务流程被使用,都不能轻易绕过约束。

不可变性还使 Money 更容易共享和测试。一个 10 CNY 参与多次计算后仍然表示 10 CNY,调用者无需担心某个方法在内部修改了原对象。

规则必须服从具体领域

“Money 永远不能为负数”并不是普遍真理。本例的非负约束适合商品价格、付款金额等场景,但账户余额、损益或调整金额可能天然需要负值。此时可以修改 Money 的不变量,也可以将“非负价格”和“可正可负调整额”建模成不同类型。

类似地,真实系统进行跨币种计算时通常需要汇率及其生效时间。更合理的做法是由专门的汇率服务把一个 Money 转换为另一个币种,再进行同币种运算,而不是让 add 在内部偷偷使用某个全局汇率。

Money 适合作为值对象,并不是因为它只有两个字段,而是因为金额的意义由这些值共同决定,运算会产生新的金额,并且币种一致性、合法范围等规则能够被稳定地封装在这个值的边界之内。

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

目录与阅读设置

阅读设置

17

记录一个想法

Money 为什么适合做值对象

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

登录哪都通