Object.equals: примеры (JAVA)

Примеры использования

Несколько простых случаев с кодом и результатом.

1) По умолчанию в Object сравнение ссылок

public class DefaultEqualsDemo {
    public static void main(String[] args) {
        Object a = new Object();
        Object b = new Object();
        Object c = a;

        System.out.println(a.equals(b)); // разные объекты
        System.out.println(a.equals(c)); // та же ссылка
    }
}

false
true

2) Переопределение equals для сравнения полей

class Person {
    private final int id;
    private final String name;

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

    @Override
    public boolean equals(Object obj) {
        if (this == obj) return true;
        if (obj == null || getClass() != obj.getClass()) return false;
        Person other = (Person) obj;
        return id == other.id && java.util.Objects.equals(name, other.name);
    }

    @Override
    public int hashCode() {
        return java.util.Objects.hash(id, name);
    }
}

public class PersonDemo {
    public static void main(String[] args) {
        Person p1 = new Person(1, "Ivan");
        Person p2 = new Person(1, "Ivan");
        System.out.println(p1.equals(p2));
    }
}

true

3) Безопасная проверка с возможным null через Objects.equals

String a = null;
String b = "text";
System.out.println(java.util.Objects.equals(a, b));
System.out.println(java.util.Objects.equals(a, null));

false
true

4) Сравнение массивов: Arrays.equals и Arrays.deepEquals

int[] x = {1,2};
int[] y = {1,2};
System.out.println(java.util.Objects.equals(x, y)); // сравнение ссылок
System.out.println(java.util.Arrays.equals(x, y));

false
true

Аналоги и смежные методы в Java

• == - проверка ссылочной (референсной) равности. Используется для определения, указывают ли ссылки на один объект.
• java.util.Objects.equals(a, b) - безопасный вызов, учитывающий null: возвращает true, если обе ссылки null или a.equals(b) при ненулевой a.
• java.util.Objects.deepEquals(a, b) - глубокое сравнение, полезно для массивов и вложенных структур; рекурсивно сравнивает содержимое массивов.
• java.util.Arrays.equals / Arrays.deepEquals - специализированные методы для массивов примитивов и массивов объектов соответственно.
• Comparable.compareTo() - не прямой аналог equals, но используется для определения порядка; для некоторых типов сравнение на равенство может выполняться через compareTo == 0.

Когда предпочтительнее: для семантического равенства - переопределять equals; для ссылочной проверки - использовать ==; для безопасной работы с возможными null - Objects.equals; для массивов - Arrays.equals/Arrays.deepEquals.

Аналоги в других языках и особенности

Ниже - краткие сравнения и примеры.

PHP

// == сравнивает по значению с приведением типов, === - строгое сравнение
var_dump(1 == '1');
var_dump(1 === '1');

bool(true)
bool(false)

JavaScript

console.log(1 == '1'); // приведение типов
console.log(1 === '1'); // строгое сравнение
console.log(Object.is(NaN, NaN));

true
false
true

Python

a = [1,2]
b = [1,2]
print(a == b)  # сравнение по значению
print(a is b)  # проверка идентичности объекта

True
False

SQL

-- В SQL равенство через =, но NULL = NULL дает UNKNOWN
SELECT (NULL = NULL) AS eq, (NULL IS NULL) AS is_null;

eq: NULL
is_null: 1

C#

object a = new object();
object b = a;
Console.WriteLine(object.Equals(a, b));
// ReferenceEquals для проверки ссылочной равенства
Console.WriteLine(object.ReferenceEquals(a, b));

True
True

Lua

-- operator == сравнивает значения; метаметод __eq можно определить для таблиц
a = {1}
b = {1}
print(a == b) -- false (разные таблицы)

false

Go (Golang)

a := []int{1,2}
b := []int{1,2}
// Срезы нельзя сравнивать через ==, нужно использовать reflect.DeepEqual
import "reflect"
println(reflect.DeepEqual(a, b))

true

Kotlin

val a = Person(1, "x")
val b = Person(1, "x")
println(a == b)   // вызывает equals
println(a === b)  // проверяет ссылочную равенство

true
false

Отличия от Java: в большинстве языков есть разделение между ссылочной и значимой семантикой; в Kotlin оператор == делегирует equals, в Go и Lua сравнение структур имеет свои ограничения, в Python == вызывает __eq__. Java требует соблюдения контракта equals/hashCode при использовании в хеш-структурах, что не во всех языках присутствует в такой форме.

Типичные ошибки и иллюстрации

• Использование == вместо equals для сравнения объектов: приводит к неверному результату, если сравниваются разные экземпляры с одинаковыми значениями.
• Вызов equals на null: если переменная равна null и вызвать на ней метод equals, будет выброшено NullPointerException. Безопаснее использовать Objects.equals(a, b).
• Нарушение контракта equals и hashCode: равные по equals объекты должны иметь одинаковый hashCode - иначе коллекции Map/Set будут работать неправильно.
• Изменение полей, участвующих в equals/hashCode после помещения объекта в HashSet/HashMap - приводит к «потерянным» элементам, которые нельзя найти через contains или get.

Пример NPE при прямом вызове:

String s = null;
System.out.println(s.equals("x"));

Exception in thread "main" java.lang.NullPointerException
    at ...

Пример с нарушением контракта hashCode, приводящий к проблемам в HashMap:

class BadKey {
    int id;
    BadKey(int id){this.id = id;}
    @Override
    public boolean equals(Object o){
        return o instanceof BadKey && id == ((BadKey)o).id;
    }
    @Override
    public int hashCode(){
        return 1; // простая, но корректная реализация - не оптимальная
    }
}

// Однако если hashCode зависит от изменяемого поля и это поле меняется после put, то возникнет проблема
BadKey k = new BadKey(1);
java.util.Map m = new java.util.HashMap<>();
m.put(k, "value");
// изменить k.id здесь приведёт к тому, что m.get(k) может вернуть null

(Возможное поведение: значение не находят; нет исключения в момент put)

Изменения в поведении и связанная функциональность

Сам метод equals унаследован от java.lang.Object и официального изменения сигнатуры не было. Важные связанные изменения в экосистеме:

• java.util.Objects, включающий Objects.equals и Objects.deepEquals, появился в Java 7 - упрощает безопасные проверки с null.
• Records (начиная с Java 14/16) автоматически генерируют equals и hashCode на основе компонентов записи, что уменьшает необходимость ручной реализации.
• Библиотеки и инструменты (например, Lombok, Apache Commons Lang) предоставляют утилиты и генераторы equals/hashCode для сокращения шаблонного кода.

Контракт equals остаётся прежним; рекомендуемая практика - применять современные средства генерации кода или record для объектов-значений.

Расширенные и редкие примеры

Несколько сложных кейсов с пояснениями.

1) Проблемы симметрии при наследовании

class A {
    int x;
    A(int x){this.x = x;}
    @Override
    public boolean equals(Object o){
        if (this == o) return true;
        if (!(o instanceof A)) return false;
        return x == ((A)o).x;
    }
}

class B extends A {
    int y;
    B(int x, int y){super(x); this.y = y;}
    @Override
    public boolean equals(Object o){
        if (this == o) return true;
        if (!(o instanceof B)) return false;
        B b = (B)o;
        return x == b.x && y == b.y;
    }
}

// Возможная проблема: a.equals(b) может вернуть true, а b.equals(a) - false, если в A.equals использован instanceof

Нарушение симметрии возможно при неправильной реализации equals в базовом классе

Комментарий: чтобы избежать, рекомендуется использовать проверку типов через getClass() или проектировать классы как неизменяемые и финальные.

2) Equals для плавающих точек и NaN

Double a = Double.NaN;
Double b = Double.NaN;
System.out.println(a.equals(b)); // true для объектов Double
System.out.println(a.doubleValue() == b.doubleValue()); // false для примитивных double с NaN

true
false

Комментарий: будьте внимательны при сравнении примитивных значений и их объектных обёрток.

3) Сравнение BigDecimal

java.math.BigDecimal d1 = new java.math.BigDecimal("1.0");
java.math.BigDecimal d2 = new java.math.BigDecimal("1.00");
System.out.println(d1.equals(d2));
System.out.println(d1.compareTo(d2) == 0);

false
true

Комментарий: BigDecimal.equals учитывает масштаб, поэтому для числового равенства лучше использовать compareTo.

4) Использование Apache Commons Lang EqualsBuilder

// пример с использованием библиотеки
import org.apache.commons.lang3.builder.EqualsBuilder;
class Point {
  private int x,y;
  @Override
  public boolean equals(Object o){
    if (o == this) return true;
    if (!(o instanceof Point)) return false;
    Point p = (Point)o;
    return new EqualsBuilder().append(x,p.x).append(y,p.y).isEquals();
  }
}

(Упрощение кода для сложных классов, результат - true/false в зависимости от полей)

5) Equals для прокси-объектов и фреймвормов

// В Spring или Hibernate прокси могут менять класс объекта; при использовании getClass() equals может стать некорректным.
// В таких случаях instanceof-основа сравнения даёт большую совместимость с прокси.

Поведение зависит от реализации прокси; возможно расхождение результатов equals в присутствии прокси.

6) Использование equals в коллекциях (пример с Set)

class Key { int id; Key(int id){this.id=id;} @Override public boolean equals(Object o){return o instanceof Key && id==((Key)o).id;} @Override public int hashCode(){return id;}}

java.util.Set s = new java.util.HashSet<>();
Key k = new Key(1);
s.add(k);
System.out.println(s.contains(new Key(1))); // true
k.id = 2; // если поле изменяемое и используется в hashCode, то contains может вернуть false
System.out.println(s.contains(k));

true
false

Комментарий: ключевое правило - поля, участвующие в equals и hashCode, лучше делать неизменяемыми.

7) Паттерн null-safe equals через Objects.equals

// безопасная реализация без явных проверок на null
@Override
public boolean equals(Object o){
    if (this == o) return true;
    if (!(o instanceof My)) return false;
    My m = (My)o;
    return java.util.Objects.equals(field1, m.field1) && java.util.Objects.equals(field2, m.field2);
}

(Эквивалентно ручным проверкам, но компактнее)