Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Java

Object.equals — uguaglianza degli oggetti

Per impostazione predefinita, Object.equals confronta l’identità degli oggetti. Ridefinendolo, una classe può stabilire l’uguaglianza per valore.

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

Sintassi

public boolean equals(Object obj)

Object.equals(Object obj) restituisce un boolean. L’implementazione in Object verifica l’identità: per riferimenti non nulli si comporta come == e non confronta automaticamente i campi. Le classi possono ridefinirlo.

Il contratto richiede riflessività, simmetria, transitività e risultati coerenti finché i dati usati per il confronto rimangono invariati. Per un x non nullo, x.equals(null) deve restituire false.

Quando si ridefinisce equals, in genere occorre ridefinire anche hashCode: gli oggetti uguali devono avere codici hash uguali; codici hash uguali non implicano che gli oggetti siano uguali.

L’esempio mostra il comportamento ereditato: la stessa istanza, un’altra istanza e un argomento null.

Esempi

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

Risultato

true
false
false

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti