CKTIS / Java
Object.equals — égalité des objets
Par défaut, Object.equals compare l’identité des objets. Une redéfinition permet à une classe de définir l’égalité par valeur.
Version : Java SE 21; repository runtime, production runtime not attested
Syntaxe
public boolean equals(Object obj)Object.equals(Object obj) renvoie un boolean. L’implémentation de Object teste l’identité : pour des références non nulles, elle se comporte comme == et ne compare pas automatiquement les champs. Les classes peuvent redéfinir cette méthode.
Le contrat exige la réflexivité, la symétrie, la transitivité et des résultats cohérents tant que les données utilisées pour la comparaison restent inchangées. Pour un x non nul, x.equals(null) doit renvoyer false.
Redéfinir equals nécessite généralement de redéfinir aussi hashCode : des objets égaux doivent avoir le même code de hachage ; des codes identiques n’impliquent pas que les objets soient égaux.
L’exemple montre le comportement hérité : la même instance, une autre instance et un argument null.
Exemples
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));
}
}Résultat
true false false
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.