CKTIS / Java
Object.hashCode — kontrakt kodu mieszającego
Object.hashCode zwraca int używany w tablicach mieszających. Obiekty równe według equals muszą mieć jednakowe kody; odwrotność nie obowiązuje.
Wersja: Java SE 21; repository runtime, production runtime not attested
Składnia
public int hashCode()Object.hashCode() to publiczna metoda instancji zwracająca int, używana przez tablice mieszające, np. HashMap. Domyślna implementacja stara się rozróżniać obiekty, ale nie gwarantuje unikalności.
Jeśli a.equals(b), musi zachodzić a.hashCode() == b.hashCode(). Kolizje są dozwolone: jednakowe kody nie dowodzą równości. Wynik musi być stały podczas jednego uruchomienia, dopóki dane używane przez equals pozostają niezmienione; między uruchomieniami może się różnić.
Nadpisując equals, zwykle trzeba również nadpisać hashCode, zachowując ten kontrakt. Przykład definiuje obie metody na podstawie niezmiennego pola id: odrębne instancje Key(7) są równe i zwracają kod 7.
Przykłady
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());
}
}Wynik
false true 7 true
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.