Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

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.

Sources