WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Java

Object.equals — Objektgleichheit

Object.equals vergleicht standardmäßig die Identität von Objekten. Durch Überschreiben kann eine Klasse Wertgleichheit festlegen.

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

Syntax

public boolean equals(Object obj)

Object.equals(Object obj) gibt boolean zurück. Die Implementierung in Object prüft die Identität: Bei nicht-null Referenzen verhält sie sich wie == und vergleicht Felder nicht automatisch. Klassen können die Methode überschreiben.

Der Vertrag verlangt Reflexivität, Symmetrie, Transitivität und konsistente Ergebnisse, solange die für den Vergleich verwendeten Daten unverändert bleiben. Für ein nicht-null x muss x.equals(null) false zurückgeben.

Wer equals überschreibt, muss im Allgemeinen auch hashCode überschreiben: Gleiche Objekte müssen gleiche Hashcodes haben; gleiche Hashcodes bedeuten nicht, dass die Objekte gleich sind.

Das Beispiel zeigt das geerbte Verhalten: dieselbe Instanz, eine andere Instanz und ein null-Argument.

Beispiele

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));
    }
}

Ergebnis

true
false
false

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen