值对象的equals和hashcode必须基于所有值字段实现结构相等，保持契约一致，并依托不可变性保障可靠性；推荐用objects.equals/hash、lombok显式指定或java记录类实现。
在 DDD 中设计 Value Object（值对象）时，equals 和 hashCode 的重写核心原则是：**两个值对象只要所有属性值相等，就视为同一逻辑实体，无论是否为同一实例**。这与 Entity（实体）不同，Value Object 没有唯一标识（ID），其“相等性”完全由内部状态决定。
基于所有属性字段实现结构相等
Value Object 的 equals 必须比较所有用于定义其概念的属性（即“值字段”），忽略无关字段（如临时缓存、序列化标记等）。推荐使用 Objects.equals() 避免空指针，且保持对称性、传递性和一致性：
- 若类含多个字段（如 Money 类含 amount 和 currency），equals 中需逐个用 Objects.equals(a, b) 判断
- 若某个字段是另一个 Value Object（如 Address 含 Street 和 City），确保该嵌套 VO 本身也正确实现了 equals
- 避免在 equals 中调用可能抛异常或依赖外部状态的方法（如数据库查询、网络请求）
hashCode 必须与 equals 保持契约一致
只要 equals 返回 true，hashCode 就必须返回相同整数。推荐使用 Objects.hash()，传入所有参与 equals 比较的字段：
Alibabacloud Sdk Client Initialization For Java
下载
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
- 例如：
return Objects.hash(amount, currency); - 字段顺序必须与 equals 中的比较顺序无关，但 hash 方法中字段顺序不影响结果，只要字段集合一致即可
- 不要在 hashCode 中包含可变字段（除非该字段在对象生命周期内绝不修改 —— Value Object 应天然不可变）
务必保证不可变性（Immutability）
Value Object 的不可变性是 equals/hashCode 可靠的前提。否则，对象加入 HashSet 或作为 HashMap Key 后，若字段被修改，会导致哈希桶错位、查找失败：
- 所有字段声明为 final
- 构造器完成全部初始化，不提供 setter
- 若字段是可变引用类型（如 List、Map），需防御性拷贝（defensive copy）或封装为不可变视图（如 Collections.unmodifiableList）
利用工具或 Lombok 简化实现（谨慎选择）
手动编写易出错，可用标准方式或工具辅助，但需理解原理：
- IDE（如 IntelliJ）可自动生成基于选定字段的 equals/hashCode，勾选“use getters”或“use records”需留意实际字段
- Lombok 的 @EqualsAndHashCode（默认包含所有非 static/non transient 字段）可用，但建议显式指定 @EqualsAndHashCode(of = {"amount", "currency"})，避免意外包含不该参与比较的字段
- Java 14+ 记录类（record）天然满足 Value Object 特性：自动实现基于所有组件字段的 equals/hashCode，且强制不可变，是极佳选择（如
record Money(BigDecimal amount, String currency) {}）
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
