Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła