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

值对象为什么适合表达业务概念

值对象为什么适合表达业务概念

业务代码里到处传递字符串、数字和日期时,类型虽然简单,却很容易把单位、格式和校验规则丢掉。值对象的价值在于把“一个值代表什么、什么值才合法、值之间如何运算”绑定在一起,让业务含义直接进入类型系统。

学习目标

  • 识别原始类型在业务代码中的表达缺陷
  • 理解值对象的不可变、按值相等和自校验特征
  • 用值对象封装金额及其运算规则

原始类型容易让规则散落

假设订单金额只用 BigDecimal 表示,代码本身无法说明这是人民币、美元还是积分,也无法保证金额非负。调用方还可能在不同位置各写一套校验,久而久之,同一个业务概念会出现多种解释。

字符串也有同样问题。邮箱、手机号、商品编码和普通备注都可以是 String,编译器无法阻止把“手机号”传进“邮箱”参数。问题不在原始类型本身,而在它们没有承载业务语义。

值对象把值和规则放在一起

值对象通常没有独立身份,判断是否相同依赖其组成值;创建后保持不可变;构造时就保证自身合法。金额、邮箱、地址、日期区间、数量和坐标都经常适合建模为值对象。

下面用 Money 演示。这个值对象同时保存金额和币种,拒绝负数,并且只允许相同币种相加。

java
import java.math.BigDecimal;
import java.util.Currency;

public class ValueObjectDemo {
    public record Money(BigDecimal amount, Currency currency) {
        public Money {
            if (amount == null || currency == null) {
                throw new IllegalArgumentException("金额和币种不能为空");
            }
            if (amount.signum() < 0) {
                throw new IllegalArgumentException("金额不能为负数");
            }

            // 统一数值刻度,避免 10.0 与 10.00 因 BigDecimal scale 不同而被判为不同值。
            amount = amount.stripTrailingZeros();
        }

        public static Money of(String amount, String currencyCode) {
            return new Money(
                    new BigDecimal(amount),
                    Currency.getInstance(currencyCode)
            );
        }

        public Money add(Money other) {
            // 跨币种相加需要汇率规则,不能在 Money 内偷偷完成。
            if (!currency.equals(other.currency)) {
                throw new IllegalArgumentException("不同币种不能直接相加");
            }
            return new Money(amount.add(other.amount), currency);
        }
    }

    public static void main(String[] args) {
        Money total = Money.of("10.00", "CNY")
                .add(Money.of("5.00", "CNY"));

        System.out.println(total.amount().toPlainString()
                + " " + total.currency().getCurrencyCode());

        boolean sameValue = Money.of("10.0", "CNY")
                .equals(Money.of("10.00", "CNY"));
        System.out.println("同值相等: " + sameValue);
    }
}

预期输出

text
15 CNY
同值相等: true

这里没有给 Money 分配 ID。两个金额和币种都相同的实例,在业务上就是同一个值;运算也返回新的 Money,而不是修改原对象。这正是值对象区别于实体的关键。

值对象带来的直接收益

把业务概念从原始类型提升为值对象,通常会得到三类收益:

  • 规则集中:格式、范围、单位和组合约束只维护一份。
  • 调用更安全:方法签名直接表达业务含义,减少把同类型参数传错位置的机会。
  • 行为靠近数据:add()、contains()、overlaps() 这类操作可以和对应概念放在一起,而不是散落在工具类中。

值对象也能减少“先创建一个非法值,再到处判断”的代码。理想情况下,对象一旦成功创建,就已经满足最基本的业务约束。

实体和值对象如何配合

实体强调“是谁”和生命周期,例如订单需要订单号来区分两个内容完全相同的订单;值对象强调“是什么值”,例如两个 10 CNY 没有必要再区分身份。

在实体内部,值对象通常作为字段参与规则判断。订单可以持有 Money totalAmount,修改金额时直接替换为新的 Money。这种做法既保留实体的身份和生命周期,也让金额自己的校验与运算规则保持封装。

不要为了追求 DDD 把每个整数和字符串都包装成类。只有当某个值拥有明确业务名称、独立规则、单位、格式或运算语义时,值对象才真正降低复杂度;否则简单类型反而更清晰。

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

目录与阅读设置

阅读设置

17

记录一个想法

值对象为什么适合表达业务概念

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

登录哪都通