值对象是不可变、无ID、基于属性相等性、自我验证的领域概念。需满足:final字段、重写equals/hashCode、无id、构造时校验;典型如Money;区别于Entity(有ID)、DTO(传输导向)、JavaBean(可变)。

值对象(Value Object)在Java面向对象设计中,核心是表达“相等性由属性决定,而非身份”的概念。它不可变、无ID、无生命周期,强调语义完整性与自我验证。设计得当的值对象能显著提升代码可读性、线程安全性与领域建模准确性。
明确值对象的核心特征
一个类要成为合格的值对象,需同时满足以下条件:
- 不可变性:所有字段声明为final,构造后状态不可更改;不提供setter方法;若含集合,应使用Collections.unmodifiableList等封装
- 基于属性的相等性:重写equals()和hashCode(),仅依据所有业务相关字段判断;避免依赖Object默认实现
- 无独立标识:不继承Entity,不定义id字段,不映射数据库主键
- 自我验证与语义完整:构造时校验逻辑合理性(如金额不能为负、邮箱格式合法),抛出IllegalArgumentException而非静默容忍
典型场景与设计示例
常见值对象包括货币、地址、时间范围、邮箱、坐标等。以Money为例:
- 字段建议包含amount(BigDecimal)和currency(String或Currency枚举)
- 构造方法内强制校验amount != null && amount.compareTo(BigDecimal.ZERO) >= 0
- 提供plus(Money other)、multiply(BigDecimal factor)等纯函数式操作,返回新实例
- 避免暴露内部字段——不提供getAmount()返回可变对象(如返回BigDecimal本身是安全的,因其本身不可变)
与实体、DTO、Bean的区别要点
容易混淆但关键不同:
立即学习“Java免费学习笔记(深入)”;
- vs 实体(Entity):实体靠ID区分,值对象靠内容区分;修改实体是更新自身,修改值对象是替换整个对象
- vs DTO:DTO是传输契约,关注序列化/反序列化,可能含冗余字段或临时状态;值对象聚焦领域语义,强调不变性与一致性
- vs JavaBean:JavaBean默认可变、有getter/setter、依赖反射;值对象拒绝setter、禁止反射修改、构造即验证
工具支持与现代实践建议
借助语言与生态降低样板代码负担:
- 用@Record(Java 14+)快速声明不可变值对象,自动实现equals/hashCode/toString,但仍需手动校验构造参数
- Lombok的@Value可简化,但注意其默认不校验,需配合@Builder和@Singular等确保构建安全
- 在DDD分层中,值对象应定义在领域层,被实体或聚合根持有,不跨层直接暴露给应用层或基础设施层










