CKTIS / Java
Redéfinir Object.equals : comparer les deux champs de Person
Définissez l’égalité des objets Person à partir du nom et de l’âge, distinguez-la de l’identité des références et implémentez un hashCode cohérent.
Version : Java SE 21
Syntaxe
@Override public boolean equals(Object obj)
@Override public int hashCode()Par défaut, Object.equals(Object) teste l’identité : pour deux références non nulles, la méthode ne renvoie true que si elles désignent le même objet. Sur des références, == teste aussi l’identité et non les valeurs des champs. Ici, deux objets Person sont égaux si name et age correspondent, même s’il s’agit d’instances distinctes.
Déclarez public boolean equals(Object obj) avec @Override pour que le compilateur vérifie la redéfinition. equals(Person) serait une surcharge et ne remplacerait pas equals(Object). Après le test rapide this == obj, le motif instanceof Person other écarte null et les objets d’autres types. Person est final, donc n’a pas de sous-classes. Comparez l’âge de type int avec == et le nom avec Objects.equals, qui considère deux valeurs null comme égales.
Pour des objets non nuls, l’égalité doit être réflexive, symétrique et transitive. Les comparaisons répétées doivent donner le même résultat tant que les données comparées ne changent pas, et x.equals(null) doit renvoyer false si x n’est pas nul. Redéfinissez aussi hashCode() à partir des deux mêmes champs : des objets égaux doivent avoir le même code de hachage, mais des objets différents peuvent aussi partager ce code.
Exemples
import java.util.Objects;
public class Main {
private static final class Person {
private final String name;
private final int age;
Person(String name, int age) {
this.name = name;
this.age = age;
}
@Override
public boolean equals(Object obj) {
if (this == obj) {
return true;
}
if (!(obj instanceof Person other)) {
return false;
}
return age == other.age && Objects.equals(name, other.name);
}
@Override
public int hashCode() {
return Objects.hash(name, age);
}
}
public static void main(String[] args) {
Person a = new Person("Ada", 28);
Object b = new Person("Ada", 28);
System.out.println(a == b);
System.out.println(b.equals(a));
System.out.println(a.equals(new Person("Ada", 29)));
System.out.println(a.equals(new Person("Eva", 28)));
System.out.println(a.equals(null));
System.out.println(a.equals("Ada"));
System.out.println(a.hashCode() == b.hashCode());
}
}Résultat
false true false false false false true
Les deux instances distinctes donnent `false` avec `==` et `true` avec `equals`, bien que `b` soit déclaré de type `Object`. Modifier l’un des champs, passer `null` ou passer un objet d’un autre type donne `false`. Les instances égales ont le même code de hachage.
Leçons associées
- Java · Leçon 28 · Intermédiaire · Version : 2
Sources
- Java SE 21 API — Object.equals(Object)
- Java SE 21 API — Object.hashCode()
- Java SE 21 API — Override
- Java SE 21 API — Objects.equals(Object, Object)
- Java SE 21 API — Objects.hash(Object...)
- Java Language Specification, Java SE 21 — §8.4.8.1 Overriding (by Instance Methods)
- Java Language Specification, Java SE 21 — §15.21.3 Reference Equality Operators