Java'da equals() ve hashCode() sözleşmesi nedir? Neden ikisini birlikte override etmek gerekir?

Sözleşme şudur: `a.equals(b)` true ise `a.hashCode() == b.hashCode()` olmak zorundadır. Tersi gerekmez; farklı nesnelerin hash'i çakışabilir (collision).

HashMap, HashSet gibi yapılar önce hashCode() ile bucket'ı bulur, sonra o bucket içinde equals() ile karşılaştırır. Sadece equals()'ı override edip hashCode()'u bırakırsanız, "eşit" iki nesne farklı bucket'lara düşer ve set içinde iki kez görünür, map.get() null döner.

public final class Email {
    private final String value;
    public Email(String value) { this.value = value.toLowerCase(); }

    @Override
    public boolean equals(Object o) {
        if (this == o) return true;
        if (!(o instanceof Email other)) return false;
        return value.equals(other.value);
    }

    @Override
    public int hashCode() { return value.hashCode(); }
}

Java 16+ ile record Email(String value) {} yazarsanız equals, hashCode ve toString otomatik ve doğru üretilir.

equals() kuralları

• Reflexive: x.equals(x) true
• Symmetric: x.equals(y) ise y.equals(x)
• Transitive, consistent ve x.equals(null) her zaman false

Tuzak: mutable key

Bir nesneyi HashMap'e key olarak koyduktan sonra hash'e giren alanını değiştirirseniz, nesne yanlış bucket'ta kalır ve artık bulunamaz. Key olarak immutable nesneler (String, record, Long) kullanın.