KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / Java

Object.equals — objectgelijkheid

Object.equals vergelijkt standaard de identiteit van objecten. Door de methode te overschrijven kan een klasse gelijkheid op basis van waarde definiëren.

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

Syntax

public boolean equals(Object obj)

Object.equals(Object obj) retourneert een boolean. De implementatie in Object test de identiteit: voor niet-null-referenties gedraagt de methode zich als == en vergelijkt ze velden niet automatisch. Klassen kunnen de methode overschrijven.

Het contract vereist reflexiviteit, symmetrie, transitiviteit en consistente resultaten zolang de gegevens die voor de vergelijking worden gebruikt niet veranderen. Voor een niet-null x moet x.equals(null) false retourneren.

Wie equals overschrijft, moet doorgaans ook hashCode overschrijven: gelijke objecten moeten gelijke hashcodes hebben; gelijke hashcodes betekenen niet dat de objecten gelijk zijn.

Het voorbeeld laat het overgeërfde gedrag zien: dezelfde instantie, een andere instantie en een null-argument.

Voorbeelden

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

Resultaat

true
false
false

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen