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.