equals() et hashCode()

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

Lorsque vous comparez des 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 vous redéfinissez equals(), vous devez également redéfinir hashCode(). Il s’agit d’un contrat en Java : les objets qui sont égaux doivent avoir le même code de hachage. Les collections fondées sur le hachage comme HashMap et HashSet dépendent de 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, ce qui garantit un comportement cohérent dans les collections.

Défi

Facile

Construisons un système de fiches d'é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'il s'agisse ou non du même objet en mémoire.

Vous allez organiser 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). Incluez un constructeur pour initialiser tous les champs ainsi que des méthodes getter pour chaque champ.
Surchargez 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 s'il s'agit de la même référence, vérifiez si la valeur est null et le type, puis comparez les champs pertinents.

Surchargez 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 étudiants. Vous recevrez six entrées représentant deux étudiants : l'identifiant, le nom et le GPA du premier étudiant, suivis de l'identifiant, du nom et du GPA du deuxième étudiant.
Créez les deux objets Student, puis effectuez trois comparaisons et affichez les résultats :
1. Affichez Same reference: , suivi de l'indication que le premier étudiant est égal à lui-même (devrait toujours être true)
2. Affichez Content equality: , suivi de l'indication que le premier étudiant est égal au deuxième étudiant (selon votre implémentation de equals)
3. Affichez Hash codes match: , suivi de l'indication que 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), le GPA du premier étudiant (double), l'identifiant du deuxième étudiant (String), le nom du deuxième étudiant (String) et le GPA du deuxième étudiant (double).

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

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 second étudiant
        String id2 = scanner.nextLine();
        String name2 = scanner.nextLine();
        double gpa2 = scanner.nextDouble();
        
        // TODO: Créer deux objets Student en utilisant les données d'entrée
        
        // TODO: Print "Same reference: " followed by whether student1 equals itself
        
        // TODO: Print "Content equality: " followed by whether student1 equals student2
        
        // TODO: Print "Hash codes match: " followed by whether both students have the same hash code
    }
}