Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / Java

Object.hashCode — smlouva o hashovacím kódu

Object.hashCode vrací int používaný hašovacími tabulkami. Objekty, které jsou podle equals stejné, musí mít stejné kódy; opačně to neplatí.

Verze: Java SE 21; repository runtime, production runtime not attested

Syntaxe

public int hashCode()

Object.hashCode() je veřejná instanční metoda, která vrací int a používají ji hašovací tabulky, například HashMap. Výchozí implementace se snaží objekty rozlišovat, ale nezaručuje jejich jedinečnost.

Pokud platí a.equals(b), musí platit také a.hashCode() == b.hashCode(). Kolize jsou povolené: stejné kódy nedokazují, že jsou objekty stejné. Výsledek musí zůstat stabilní během jednoho spuštění, dokud se nezmění data používaná metodou equals; mezi spuštěními se může lišit.

Při přepsání metody equals je obvykle nutné přepsat také hashCode, aby byla tato smlouva dodržena. Příklad definuje obě metody podle neměnného pole id: různé instance Key(7) jsou stejné a vracejí kód 7.

Příklady

public class Main {
    static final class Key {
        private final int id;

        Key(int id) {
            this.id = id;
        }

        @Override
        public boolean equals(Object other) {
            return other instanceof Key && id == ((Key) other).id;
        }

        @Override
        public int hashCode() {
            return id;
        }
    }

    public static void main(String[] args) {
        Key a = new Key(7);
        Key b = new Key(7);
        System.out.println(a == b);
        System.out.println(a.equals(b));
        System.out.println(a.hashCode());
        System.out.println(a.hashCode() == b.hashCode());
    }
}

Výsledek

false
true
7
true

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje