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.