Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

System.identityHashCode — kod skrótu tożsamości obiektu

System.identityHashCode zwraca kod skrótu wynikający z tożsamości obiektu, pomijając przesłoniętą metodę hashCode(). Dla null zwraca 0. Wynik nie jest unikalnym identyfikatorem i nie zastępuje porównania referencji operatorem ==.

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

Składnia

public static int identityHashCode(Object x)

System.identityHashCode(Object x) jest metodą statyczną zwracającą int: taki kod skrótu, jaki dla obiektu zwróciłaby domyślna implementacja Object.hashCode(). Nie wywołuje przesłoniętej metody hashCode() klasy obiektu. Dla null zwraca 0, zamiast zgłaszać wyjątek.

Zwykłe wywołanie x.hashCode() korzysta z implementacji wybranej dla rzeczywistej klasy obiektu; może ona obliczać skrót na podstawie jego zawartości. System.identityHashCode(x) dotyczy tożsamości konkretnej instancji, a nie równości wartości określonej przez equals(). Dwa obiekty równe według equals() nie muszą mieć jednakowych kodów skrótu tożsamości.

Dla tego samego obiektu wynik pozostaje stały w obrębie jednego uruchomienia, ale nie musi być taki sam w kolejnych uruchomieniach. Różne obiekty mogą otrzymać ten sam wynik: kolizje są dozwolone. Dlatego jednakowe wyniki nie dowodzą, że referencje wskazują ten sam obiekt; do takiego sprawdzenia służy ==. Nie traktuj wyniku jako unikalnego identyfikatora, trwałego klucza ani gwarantowanego adresu pamięci.

W przykładzie item i alias wskazują ten sam obiekt. Przesłonięta metoda hashCode() celowo zgłasza AssertionError, więc jej przypadkowe wywołanie byłoby widoczne. Program porównuje wyniki zamiast wypisywać nieprzewidywalną wartość skrótu; oczekiwane wyjście to true, true i 0, każde w osobnym wierszu.

Przykłady

public class Main {
    static final class Item {
        @Override
        public int hashCode() {
            throw new AssertionError("hashCode override called");
        }
    }

    public static void main(String[] args) {
        Item item = new Item();
        Item alias = item;
        int hash = System.identityHashCode(item);

        System.out.println(item == alias);
        System.out.println(hash == System.identityHashCode(alias));
        System.out.println(System.identityHashCode(null));
    }
}

Wynik

true
true
0

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła