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.