CKTIS / Java
Object.equals — rovnosť objektov
Object.equals predvolene porovnáva identitu objektov. Prepísaním tejto metódy môže trieda definovať rovnosť podľa hodnoty.
Verzia: Java SE 21; repository runtime, production runtime not attested
Syntax
public boolean equals(Object obj)Object.equals(Object obj) vracia boolean. Implementácia v Object testuje identitu: pri nenulových referenciách sa správa ako == a automaticky neporovnáva polia. Triedy môžu túto metódu prepísať.
Kontrakt vyžaduje reflexivitu, symetriu, tranzitivitu a konzistentné výsledky, pokiaľ sa nezmenia údaje použité pri porovnávaní. Pre nenulové x musí x.equals(null) vrátiť false.
Pri prepísaní equals je zvyčajne potrebné prepísať aj hashCode: rovnaké objekty musia mať rovnaké hashovacie kódy; rovnaké hashovacie kódy neznamenajú, že objekty sú rovnaké.
Príklad ukazuje zdedené správanie: tú istú inštanciu, inú inštanciu a argument null.
Príklady
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));
}
}Výsledok
true false false
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.