equals() et hashCode()

Fait partie de la section Programmation Orientée Objet du Journey Java de Coddy. Leçon 42 sur 87.

Lors de la comparaison d’objets en Java, l’opérateur == vérifie si deux références pointent vers le même emplacement mémoire. Pour comparer le contenu réel des objets, vous devez redéfinir la méthode equals().

public class Person {
    private String name;
    private int age;
    
    @Override
    public boolean equals(Object obj) {
        if (this == obj) return true;
        if (obj == null || getClass() != obj.getClass()) return false;
        Person person = (Person) obj;
        return age == person.age && name.equals(person.name);
    }
}

La méthode equals() suit un modèle standard : vérifiez d’abord s’il s’agit du même objet, puis vérifiez le type et enfin comparez les champs pertinents.

Chaque fois que tu redéfinis equals(), tu dois aussi redéfinir hashCode(). C’est une règle contractuelle en Java : les objets égaux doivent avoir le même code de hachage. Les collections basées sur le hachage comme HashMap et HashSet s’appuient sur cette règle pour fonctionner correctement.

@Override
public int hashCode() {
    return Objects.hash(name, age);
}

La méthode utilitaire Objects.hash() génère un code de hachage à partir des mêmes champs que ceux utilisés dans equals(). Si deux objets Person ont le même nom et le même âge, ils seront considérés comme égaux et produiront des codes de hachage identiques, garantissant un comportement cohérent dans les collections.

Défi

Facile

Construisons un système de dossiers étudiants qui implémente correctement l’égalité des objets. Vous allez créer une classe Student dans laquelle deux étudiants sont considérés comme égaux s’ils ont le même identifiant étudiant et le même nom, qu’ils soient ou non le même objet en mémoire.

Vous allez répartir votre code sur deux fichiers :

Student.java : créez une classe représentant un étudiant avec trois champs privés : studentId (String), name (String) et gpa (double). Ajoutez un constructeur pour initialiser tous les champs ainsi que des méthodes getter pour chacun d’eux.
Redéfinissez la méthode equals() afin que deux objets Student soient considérés comme égaux lorsqu’ils ont le même studentId ET le même name. Suivez le modèle standard : vérifiez qu’il s’agit de la même référence, vérifiez que l’objet n’est pas nul et qu’il est du bon type, puis comparez les champs concernés.

Redéfinissez la méthode hashCode() en utilisant Objects.hash() avec les mêmes champs que ceux utilisés dans equals(). N’oubliez pas d’importer java.util.Objects en haut de votre fichier.
Main.java : donnez vie à votre classe Student en comparant des objets étudiant. Vous recevrez six entrées représentant deux étudiants : l’identifiant, le nom et la moyenne du premier étudiant, puis l’identifiant, le nom et la moyenne du deuxième étudiant.
Créez les deux objets Student, puis effectuez trois comparaisons et affichez les résultats :
1. Affichez Same reference: suivi du résultat indiquant si le premier étudiant est égal à lui-même (le résultat devrait toujours être true)
2. Affichez Content equality: suivi du résultat indiquant si le premier étudiant est égal au deuxième (selon votre implémentation de equals)
3. Affichez Hash codes match: suivi du résultat indiquant si les deux étudiants ont le même code de hachage

Vous recevrez six entrées : l’identifiant du premier étudiant (String), le nom du premier étudiant (String), la moyenne du premier étudiant (double), l’identifiant du deuxième étudiant (String), le nom du deuxième étudiant (String) et la moyenne du deuxième étudiant (double).

Remarquez que lorsque deux étudiants ont des identifiants et des noms identiques, equals() renvoie true ET leurs codes de hachage correspondent. C’est le contrat que vous devez respecter !

Essayez vous-même

import java.util.Scanner;

class Main {
    public static void main(String[] args) {
        Scanner scanner = new Scanner(System.in);
        
        // Lire les données du premier étudiant
        String id1 = scanner.nextLine();
        String name1 = scanner.nextLine();
        double gpa1 = scanner.nextDouble();
        scanner.nextLine(); // consommer le saut de ligne
        
        // Lire les données du deuxième étudiant
        String id2 = scanner.nextLine();
        String name2 = scanner.nextLine();
        double gpa2 = scanner.nextDouble();
        
        // TODO: Créer deux objets Student à partir des données saisies
        
        // TODO: Afficher "Same reference: " suivi du résultat de la comparaison de student1 avec lui-même
        
        // TODO: Afficher "Content equality: " suivi du résultat de la comparaison de student1 avec student2
        
        // TODO: Afficher "Hash codes match: " suivi de l’indication que les deux étudiants ont ou non le même code de hachage
    }
}