Как правильно переопределять метод equals в Java?

// Пример минимально корректного переопределения equals
class MyClass {
    private int id;
    private String name;

    public MyClass(int id, String name) {
        this.id = id;
        this.name = name;
    }

    @Override // Обязательная аннотация
    public boolean equals(Object o) {
        // 1. Проверка на тождество
        if (this == o) return true;
        // 2. Проверка на null и совпадение классов
        // Используем getClass() для строгой проверки
        if (o == null || getClass() != o.getClass()) return false;
        // 3. Приведение типа
        MyClass myClass = (MyClass) o;
        // 4. Сравнение значимых полей
        return id == myClass.id &&
               // Используем Objects.equals для сравнения объектов (учитывает null)
               Objects.equals(name, myClass.name);
    }
}

Правила для корректного переопределения equals (согласно контракту Object.equals):

• Рефлексивность: Для любого ненулевого ссылочного значения x, x.equals(x) должно возвращать true.
• Симметричность: Для любых ненулевых ссылочных значений x и y, x.equals(y) должно возвращать true тогда и только тогда, когда y.equals(x) возвращает true.
• Транзитивность: Для любых ненулевых ссылочных значений x, y, и z, если x.equals(y) возвращает true и y.equals(z) возвращает true, то x.equals(z) должно возвращать true.
• Согласованность: Для любых ненулевых ссылочных значений x и y, многократный вызов x.equals(y) должен последовательно возвращать true или последовательно возвращать false, при условии, что информация, используемая при сравнении объектов, не изменялась.
• Для любого ненулевого ссылочного значения x, x.equals(null) должно возвращать false.

Рекомендуется использовать Objects.equals(obj1, obj2) для безопасного сравнения объектов, так как он корректно обрабатывает null.

Всегда переопределяйте hashCode() при переопределении equals() в соответствии с общим контрактом Object.hashCode: если два объекта равны согласно методу equals(Object), их хэш-коды, возвращаемые методом hashCode(), должны быть одинаковыми. Обратное утверждение не требуется. Невыполнение этого правила приведет к некорректной работе коллекций, основанных на хэш-таблицах (например, HashMap, HashSet).

// Пример соответствующего hashCode для MyClass
class MyClass {
    private int id;
    private String name;

    // ... конструктор и equals как выше ...

    @Override
    public int hashCode() {
        // Использование Objects.hash для удобного вычисления хэша
        return Objects.hash(id, name);
    }
}

Можно сгенерировать методы equals и hashCode автоматически с помощью IDE (IntelliJ IDEA, Eclipse), что является хорошей практикой.

Используйте instanceof вместо getClass() только если класс является частью иерархии наследования, и вам нужно, чтобы объекты суперкласса и подкласса считались равными, если они имеют одинаковое состояние. В большинстве случаев предпочтительнее использовать getClass() для строгой проверки.