Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

Object.equals — równość obiektów

Object.equals domyślnie porównuje tożsamość obiektów. Nadpisanie pozwala określić równość wartości.

Wersja: Java SE 21; repository runtime, production runtime not attested

Składnia

public boolean equals(Object obj)

Object.equals(Object obj) zwraca boolean. Implementacja w Object sprawdza tożsamość: dla niepustych referencji działa jak ==, nie porównuje automatycznie pól. Klasy mogą ją nadpisywać.

Kontrakt wymaga zwrotności, symetrii i przechodniości oraz spójnych wyników, dopóki dane używane do porównania pozostają niezmienione. Dla niepustego x wywołanie x.equals(null) musi zwracać false.

Nadpisując equals, zwykle trzeba też nadpisać hashCode: równe obiekty muszą mieć jednakowe kody; jednakowe kody nie oznaczają równości.

Przykład pokazuje odziedziczone zachowanie: ta sama instancja, inna instancja i argument null.

Przykłady

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

        System.out.println(a.equals(same));
        System.out.println(a.equals(b));
        System.out.println(a.equals(null));
    }
}

Wynik

true
false
false

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła