Какие знаешь методы, работающие в паре с equals?

Методы, работающие в паре с equals

Контект: equals и hashCode

В Java существует фундаментальное правило: если вы переопределяете метод equals(), вы обязаны переопределить метод hashCode(). Это не просто рекомендация, а требование контракта java.lang.Object, игнорирование которого приводит к серьёзным ошибкам при использовании объектов в хеш-структурах (HashMap, HashSet, Hashtable).

Метод hashCode()

hashCode() возвращает целое число (32-битное целое), которое служит хешем объекта. Контракт между equals() и hashCode() гласит:

• Если два объекта равны по equals(), их hashCode() должен быть одинаков
• Обратное неверно: разные объекты могут иметь одинаковый hashCode (коллизия)

public class User {
    private String email;
    private int age;

    @Override
    public boolean equals(Object obj) {
        if (this == obj) return true;
        if (obj == null || getClass() != obj.getClass()) return false;
        User user = (User) obj;
        return age == user.age && 
               Objects.equals(email, user.email);
    }

    @Override
    public int hashCode() {
        return Objects.hash(email, age);
    }
}

Почему это критично?

Рассмотрим пример нарушения контракта:

public class BadExample {
    private String name;

    @Override
    public boolean equals(Object obj) {
        if (!(obj instanceof BadExample)) return false;
        return name.equals(((BadExample) obj).name);
    }

    // hashCode НЕ переопределён!
    // Используется стандартный: основан на адресе памяти
}

// Проблема:
BadExample obj1 = new BadExample("John");
BadExample obj2 = new BadExample("John");

Set<BadExample> set = new HashSet<>();
set.add(obj1);
set.contains(obj2); // false! Хотя obj1.equals(obj2) == true

Почему? HashSet сначала проверяет hashCode(). Если хешы разные — объект не найдётся, даже если equals() вернёт true.

Правила реализации hashCode()

1. Используй один и тот же набор полей как в equals()
2. Используй Objects.hash() для удобства (с Java 7+)
3. Если поле null — Objects.hash() это обработает
4. Результат должен быть детерминированным — одни и те же данные → один и тот же хеш

public class Product {
    private String id;
    private String category;
    private BigDecimal price;

    @Override
    public boolean equals(Object o) {
        if (this == o) return true;
        if (o == null || getClass() != o.getClass()) return false;
        Product product = (Product) o;
        return Objects.equals(id, product.id);
    }

    @Override
    public int hashCode() {
        // Используем ТОЛЬКО поля, участвующие в equals
        return Objects.hash(id);
    }
}

Другие сопутствующие методы

compareTo() (Comparable и Comparator) — тоже должны согласовываться с equals():

public class Version implements Comparable<Version> {
    private int major, minor, patch;

    @Override
    public int compareTo(Version other) {
        if (major != other.major) return major - other.major;
        if (minor != other.minor) return minor - other.minor;
        return patch - other.patch;
    }

    @Override
    public boolean equals(Object o) {
        if (!(o instanceof Version)) return false;
        Version v = (Version) o;
        return major == v.major && minor == v.minor && patch == v.patch;
    }
}

Итоги

• equals() и hashCode() неразделимы в Java
• Используй Objects.hash() для простоты
• Переопределяй compareTo() если нужна сортировка
• Тестируй поведение в коллекциях (HashSet, HashMap)