Java 默认的 equals() 方法仅比较引用是否相同，若需按业务逻辑判断对象内容是否一致（如两个 StateMachine 是否状态相同），必须重写 equals() 和 hashCode() 方法。
java 默认的 `equals()` 方法仅比较引用是否相同，若需按业务逻辑判断对象内容是否一致（如两个 statemachine 是否状态相同），必须重写 `equals()` 和 `hashcode()` 方法。
在 Java 中，Object.equals() 的默认实现等价于 ==，即仅当两个变量指向同一内存地址的对象时才返回 true。这意味着即使两个 StateMachine 实例内部 lamps 映射完全一致（相同 key、相同 LED 属性值），只要它们是不同对象实例，instance1.equals(instance2) 就会返回 false——这显然不符合“按状态值比较”的业务需求。
要实现基于内容的相等性判断，必须在 StateMachine 类中显式重写 equals() 和 hashCode() 方法。关键原则是：
✅ 若 a.equals(b) 为 true，则 a.hashCode() 必须等于 b.hashCode()；
✅ equals() 必须满足自反性、对称性、传递性、一致性及对 null 的安全性。
以下是推荐的实现方式（使用现代 Java 推荐实践）：
public class StateMachine {
private final Map<Integer, LED> lamps = new HashMap<>();
@Override
public boolean equals(Object o) {
if (this == o) return true;
if (o == null || getClass() != o.getClass()) return false;
StateMachine that = (StateMachine) o;
return lamps.equals(that.lamps); // 依赖 Map 的 equals（递归比较键值对）
}
@Override
public int hashCode() {
return Objects.hash(lamps); // 自动处理 null 安全与字段组合
}
}⚠️ 注意事项：
-
LED类本身也必须正确实现equals()和hashCode()，否则lamps.equals(...)将退化为引用比较。例如，LED应忽略onStateDrawable和offStateDrawable（因Drawable不适合值比较），仅基于onState、updateRequired、Id、Key等可序列化/可比较字段判断：立即学习“Java免费学习笔记（深入）”；
javascript-typescript-typescript-scaffold下载你是 TypeScript 项目架构专家，专注于脚手架搭建生产就绪的 Node.js 和前端应用。生成包含现代工具链（pnpm、Vite、Next.js）、类型
public class LED { public boolean onState; public boolean updateRequired; public int Id; public String Key; // Drawable 字段不参与 equals/hashCode（避免 NPE 和不可预测行为） @Override public boolean equals(Object o) { if (this == o) return true; if (o == null || getClass() != o.getClass()) return false; LED led = (LED) o; return onState == led.onState && updateRequired == led.updateRequired && Id == led.Id && Objects.equals(Key, led.Key); } @Override public int hashCode() { return Objects.hash(onState, updateRequired, Id, Key); } } 建议将
lamps声明为final并使用Collections.unmodifiableMap()封装（若设计为不可变），增强线程安全与语义清晰性；避免在
equals()中执行耗时操作（如 I/O 或复杂计算），保持时间复杂度为 O(n)；使用 IDE（如 IntelliJ IDEA）或 Lombok 的
@EqualsAndHashCode可自动生成健壮代码，但务必审查生成逻辑是否符合业务语义。
总结：值相等 ≠ 引用相等。只有主动定义“什么是相等”，Java 才能按你的意图工作——这是面向对象封装与契约精神的核心体现。
