Neden `equals()` ve `hashCode()` metodlarını birlikte override etmelisiniz?

Question

Accepted Answer

Mantıksal eşitliği tanımlamak için `equals()` metodunu override ettiğinizde, **aynı zamanda `hashCode()` metodunu da override etmelisiniz** — çünkü hash tabanlı koleksiyonlar (`HashMap`, `HashSet`) **eşit nesnelerin aynı hash kodlarına sahip olması** sözleşmesine güvenirler. Bu sözleşmeyi bozmak, bulması zor ve sinsi hatalar üretir. ## Varsayılan davranış ```java // by default, equals() compares IDENTITY (same object?), hashCode() is based on memory address Person p1 = new Person("Ann", 30); Person p2 = new Person("Ann", 30); p1.equals(p2); // false by default — different objects, even with same data ``` Override etmeden, aynı içeriğe sahip iki nesne "eşit değildir" — genellikle değer nesneleri için istediğiniz şey değildir. ## Mantıksal eşitlik için equals() override etmek ```java @Override public boolean equals(Object o) { if (this == o) return true; if (o == null || getClass() != o.getClass()) return false; Person p = (Person) o; return age == p.age && Objects.equals(name, p.name); // compare by CONTENT } ``` ## Kritik kural: aynı zamanda hashCode() override edin ```java @Override public int hashCode() { return Objects.hash(name, age); // MUST be consistent with equals() } ``` **Sözleşme:** eğer `a.equals(b)` doğruysa, o zaman `a.hashCode() == b.hashCode()` **mutlaka** doğru olmalıdır. ## equals() override ederseniz ama hashCode() override etmezseniz ne kırılır ```java Person p1 = new Person("Ann", 30); Person p2 = new Person("Ann", 30); // equal by our equals() Set set = new HashSet<>(); set.add(p1); set.contains(p2); // ❌ likely FALSE — even though p1.equals(p2)! ``` Neden? HashMap/HashSet önce doğru **bucket** (demet) bulabilmek için `hashCode()` kullanır, sonra içinde `equals()` ile karşılaştırma yapar. Varsayılan (identity tabanlı) `hashCode()` ile `p1` ve `p2` *farklı* bucketlere düşer, bu yüzden `contains` onları hiçbir zaman karşılaştırmaz — küme onları farklı olarak düşünür. Bu kafa karıştırıcı hatalar üretir: Setteki yinelemeler, başarısız harita aramaları vb. ## Sözleşme kuralları ```text 1. equal objects → equal hash codes (REQUIRED for correctness) 2. unequal objects MAY have the same hash (collisions are allowed) 3. hashCode() must be consistent (same object → same code, unchanged) 4. equals() must be reflexive, symmetric, transitive, consistent ``` ## Modern kısayol ```java record Person(String name, int age) {} // records auto-generate equals/hashCode/toString! ``` Java **records** (ve IDE oluşturulan kod / Lombok) sizin için doğru, tutarlı `equals`/`hashCode` üretir. ## Neden önemli equals/hashCode sözleşmesi Java'nın en önemli — ve en sık ihlal edilen — kurallarından biridir. `equals()` metodunu `hashCode()` olmadan override etmek, hash tabanlı koleksiyonları hata ayıklaması zor olan yollarla kırır: eşit olduğunu düşündüğünüz nesneler `HashMap`/`HashSet` içinde "kaybolur" (başarısız aramalar, hayalet yinelemeler) çünkü farklı bucketlere hash edilirler. Bu koleksiyonlar her yerde kullanıldığından, bir anahtar veya set elemanı olarak kullanılan her değer türü sınıfı **her ikisini de** tutarlı şekilde override etmelidir. *Neden* (bucket-then-equals arama mekanizması) anlamak — ve bunu doğru yapmak için records veya oluşturulan kodu kullanmak — doğru davranış için gereklidir ve Java koleksiyonlarının nasıl çalıştığı hakkında gerçek bir anlayışı ortaya çıkaran klasik bir mülakat sorusudur.