equals() y hashCode()

Parte de la sección Programación Orientada a Objetos del Journey de Java de Coddy. Lección 42 de 87.

Al comparar objetos en Java, el operador == comprueba si dos referencias apuntan a la misma ubicación de memoria. Para comparar el contenido real de los objetos, debes sobrescribir el método 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);
    }
}

El método equals() sigue un patrón estándar: primero comprueba si es el mismo objeto, después verifica el tipo y, por último, compara los campos pertinentes.

Siempre que sobrescribas equals(), también debes sobrescribir hashCode(). Este es un contrato de Java: los objetos que son iguales deben tener el mismo código hash. Las colecciones basadas en hash, como HashMap y HashSet, dependen de esta regla para funcionar correctamente.

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

El método de utilidad Objects.hash() genera un código hash a partir de los mismos campos que se usan en equals(). Si dos objetos Person tienen el mismo nombre y la misma edad, se considerarán iguales y producirán códigos hash idénticos, lo que garantiza un comportamiento coherente en las colecciones.

Desafío

Fácil

Construyamos un sistema de registros de estudiantes que implemente correctamente la igualdad entre objetos. Crearás una clase Student en la que dos estudiantes se consideran iguales si tienen el mismo ID de estudiante y el mismo nombre, independientemente de que sean el mismo objeto en memoria.

Organizarás tu código en dos archivos:

Student.java: Crea una clase que represente a un estudiante con tres campos privados: studentId (String), name (String) y gpa (double). Incluye un constructor para inicializar todos los campos y métodos getter para cada campo.
Sobrescribe el método equals() para que dos objetos Student se consideren iguales cuando tengan el mismo studentId Y el mismo name. Sigue el patrón estándar: comprueba si tienen la misma referencia, comprueba si el otro valor es null y su tipo, y luego compara los campos pertinentes.

Sobrescribe el método hashCode() usando Objects.hash() con los mismos campos utilizados en equals(). Recuerda importar java.util.Objects al principio de tu archivo.
Main.java: Dale vida a tu clase Student comparando objetos estudiante. Recibirás seis entradas que representan a dos estudiantes: el ID, el nombre y el GPA del primer estudiante, seguidos del ID, el nombre y el GPA del segundo estudiante.
Crea ambos objetos Student, después realiza tres comparaciones e imprime los resultados:
1. Imprime Same reference: seguido de si el primer estudiante es igual a sí mismo (debería ser siempre true)
2. Imprime Content equality: seguido de si el primer estudiante es igual al segundo (según tu implementación de equals)
3. Imprime Hash codes match: seguido de si ambos estudiantes tienen el mismo código hash

Recibirás seis entradas: el ID del primer estudiante (String), el nombre del primer estudiante (String), el GPA del primer estudiante (double), el ID del segundo estudiante (String), el nombre del segundo estudiante (String) y el GPA del segundo estudiante (double).

Observa que cuando dos estudiantes tienen los mismos ID y nombre, tanto equals() devuelve true COMO sus códigos hash coinciden. ¡Este es el contrato que debes mantener!

Pruébalo tú mismo

import java.util.Scanner;

class Main {
    public static void main(String[] args) {
        Scanner scanner = new Scanner(System.in);
        
        // Lee los datos del primer estudiante
        String id1 = scanner.nextLine();
        String name1 = scanner.nextLine();
        double gpa1 = scanner.nextDouble();
        scanner.nextLine(); // consume el salto de línea
        
        // Lee los datos del segundo estudiante
        String id2 = scanner.nextLine();
        String name2 = scanner.nextLine();
        double gpa2 = scanner.nextDouble();
        
        // TODO: Crea dos objetos Student usando los datos de entrada
        
        // TODO: Imprime "Same reference: " seguido de si student1 es igual a sí mismo
        
        // TODO: Imprime "Content equality: " seguido de si student1 es igual a student2
        
        // TODO: Imprime "Hash codes match: " seguido de si ambos estudiantes tienen el mismo código hash
    }
}