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.