Когда вы переопределяете equals() для определения логического равенства, вы должны также переопределить hashCode() — потому что коллекции на основе хеша (HashMap, ) полагаются на контракт, что . Нарушение этого приводит к незаметным, трудноуловимым ошибкам.
HashSet// by default, equals() compares IDENTITY (same object?), hashCode() is based on memory address
Person p1 = new Person("Ann", 30);
Person p2 = new Person("Ann", 30);
p1.equals(p2); // false by default — different objects, even with same data
Без переопределения два объекта с одинаковым содержимым не являются "равными" — обычно это не то, что вам нужно для объектов-значений.
@Override
public boolean equals(Object o) {
if (this == o) return true;
if (o == null || getClass() != o.getClass()) return false;
Person p = (Person) o;
return age == p.age && Objects.equals(name, p.name); // compare by CONTENT
}
@Override
public int hashCode() {
return Objects.hash(name, age); // MUST be consistent with equals()
}
Контракт: если a.equals(b) возвращает true, то a.hashCode() == b.hashCode() должно быть true.
Person p1 = new Person("Ann", 30);
Person p2 = new Person("Ann", 30); // equal by our equals()
Set<Person> set = new HashSet<>();
set.add(p1);
set.contains(p2); // ❌ likely FALSE — even though p1.equals(p2)!
Почему? HashMap/HashSet сначала используют hashCode() для поиска нужного бакета, затем equals() внутри него. С кодом хеша по умолчанию (на основе идентичности) p1 и p2 попадают в разные бакеты, поэтому contains никогда их даже не сравнивает — множество считает их разными. Это создаёт озадачивающие баги: дубликаты в Set, неудачные поиски в map и т.д.
1. equal objects → equal hash codes (REQUIRED for correctness)
2. unequal objects MAY have the same hash (collisions are allowed)
3. hashCode() must be consistent (same object → same code, unchanged)
4. equals() must be reflexive, symmetric, transitive, consistent
record Person(String name, int age) {} // records auto-generate equals/hashCode/toString!
Java records (и генерация IDE / Lombok) автоматически производят корректный и согласованный equals/hashCode для вас.
Контракт equals/hashCode — одно из самых важных — и наиболее часто нарушаемых — правил Java.
Переопределение equals() без hashCode() ломает коллекции на основе хеша способами, которые сложно отладить: объекты, которые вы считаете равными, "теряются" в HashMap/HashSet (неудачные поиски, фантомные дубликаты), потому что они хешируются в разные бакеты.
Поскольку эти коллекции повсеместны, каждый класс типа-значения, используемый как ключ или элемент множества, должен переопределять оба метода согласованно.
Понимание почему (механизм поиска по бакету и затем сравнение) — и использование records или сгенерированного кода для правильного результата — существенно для корректного поведения и является классической темой на собеседованиях, которая выявляет настоящее понимание того, как работают коллекции в Java.