Cosa fa il metodo equals() in Java?

Il metodo equals() in Java viene utilizzato per confrontare il contenuto di due oggetti. Per impostazione predefinita, nella classe Object, confronta i riferimenti degli oggetti, cioè determina se due variabili puntano allo stesso oggetto in memoria.

Tuttavia, la maggior parte delle classi in Java (ad esempio, String, Integer) ridefiniscono questo metodo per confrontare i valori contenuti negli oggetti, piuttosto che i loro riferimenti.

Quando si ridefinisce equals(), è importante rispettare il suo contratto:

• Riflessività: x.equals(x) dovrebbe essere true per ogni x non nullo.
• Simmetria: x.equals(y) dovrebbe essere true se e solo se y.equals(x) è true per ogni x e y non nulli.
• Transitività: Se x.equals(y) e y.equals(z) sono true, allora x.equals(z) dovrebbe essere true per ogni x, y, z non nulli.
• Consistenza: Le chiamate multiple a x.equals(y) dovrebbero restituire lo stesso risultato, a meno che gli oggetti non cambino.
• **Per ogni x non nullo, x.equals(null) dovrebbe essere false.

Esempio di ridefinizione di equals():

class MyObject {
    private int value;

    public MyObject(int value) {
        this.value = value;
    }

    @Override
    public boolean equals(Object obj) {
        if (this == obj) {
            return true;
        }
        if (obj == null || getClass() != obj.getClass()) {
            return false;
        }
        MyObject myObject = (MyObject) obj;
        return value == myObject.value;
    }
}

Utilizzo di equals():

// Confronto per riferimento (predefinito in Object)
Object obj1 = new Object();
Object obj2 = new Object();
boolean perRiferimento = obj1.equals(obj2); // false

// Confronto per valore (dopo aver ridefinito `equals`)
MyObject myObj1 = new MyObject(10);
MyObject myObj2 = new MyObject(10);
boolean perValore = myObj1.equals(myObj2); // true

È inoltre importante ridefinire il metodo hashCode() quando si ridefinisce equals(), per mantenere il loro contratto e evitare problemi con le collezioni che utilizzano l'hashing (ad esempio, HashMap, HashSet).