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.