Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / Java

Object.equals — rovnost objektů

Object.equals ve výchozím nastavení porovnává identitu objektů. Přepsáním této metody může třída definovat rovnost podle hodnoty.

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

Syntaxe

public boolean equals(Object obj)

Object.equals(Object obj) vrací boolean. Implementace v Object testuje identitu: pro nenulové reference se chová jako == a automaticky neporovnává pole. Třídy mohou tuto metodu přepsat.

Kontrakt vyžaduje reflexivitu, symetrii, tranzitivitu a konzistentní výsledky, dokud se nezmění data použitá při porovnání. Pro nenulové x musí x.equals(null) vrátit false.

Při přepsání equals je obvykle nutné přepsat také hashCode: stejné objekty musí mít stejné hashovací kódy; stejné hashovací kódy neznamenají, že jsou objekty stejné.

Příklad ukazuje zděděné chování: stejnou instanci, jinou instanci a argument null.

Pří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ýsledek

true
false
false

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje