Что делает метод equals() в Java?

Метод equals() в Java используется для сравнения двух объектов на равенство. По умолчанию, в случае объектов, наследующих от Object без его переопределения, он сравнивает ссылки на объекты (==), то есть проверяет, указывают ли переменные на один и тот же участок памяти.

Корректное переопределение метода equals() важно для сравнения объектов по их содержимому, а не по их местоположению в памяти.

При переопределении 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) должны стабильно возвращать один и тот же результат, при условии, что информация, используемая для сравнения в обоих объектах, не изменялась между вызовами.
• Для любого ненулевого объекта x, x.equals(null) должно возвращать false.

Обычно при переопределении equals(), также необходимо переопределить метод hashCode(), поддерживая контракт: если два объекта равны согласно методу equals(), то их хеш-коды, возвращаемые методом hashCode(), должны быть одинаковыми. Обратное не обязательно: если хеш-коды одинаковы, объекты не обязательно равны.

Пример переопределения:

public class MyObject {
    private int value;
    private String name;

    public MyObject(int value, String name) {
        this.value = value;
        this.name = name;
    }

    @Override
    public boolean equals(Object o) {
        // Само сравнение
        if (this == o) return true;
        // Проверка на null и тип объекта
        if (o == null || getClass() != o.getClass()) return false;
        // Приведение типа и сравнение по полям
        MyObject myObject = (MyObject) o;
        return value == myObject.value &&
               Objects.equals(name, myObject.name);
    }

    @Override
    public int hashCode() {
        // Генерация хеш-кода на основе полей
        return Objects.hash(value, name);
    }

    // геттеры, сеттеры и т.д.
}