Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / Java

System.identityHashCode — hashovací kód identity objektu

System.identityHashCode vrací hashovací kód založený na identitě objektu a obchází přepsanou metodu hashCode(). Pro null vrací 0. Výsledek není jedinečný identifikátor a nenahrazuje porovnání referencí pomocí ==.

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

Syntaxe

public static int identityHashCode(Object x)

System.identityHashCode(Object x) je statická metoda, která vrací int: hashovací kód, který by pro objekt vrátila výchozí implementace Object.hashCode(). Nevolá přepsanou metodu hashCode() třídy objektu. Pro null vrací 0 místo vyvolání výjimky.

Běžné volání x.hashCode() používá implementaci vybranou pro skutečnou třídu objektu; ta může vypočítat hash z jeho obsahu. System.identityHashCode(x) se týká identity konkrétní instance, nikoli hodnotové rovnosti definované metodou equals(). Dva objekty, které jsou podle equals() stejné, nemusí mít stejné hashovací kódy identity.

Pro tentýž objekt zůstává výsledek během jednoho spuštění stejný, ale při různých spuštěních stejný být nemusí. Různé objekty mohou získat stejný výsledek: kolize jsou přípustné. Stejné výsledky tedy nedokazují, že reference ukazují na tentýž objekt; k ověření použijte ==. Nepovažujte výsledek za jedinečný identifikátor, trvalý klíč ani zaručenou adresu v paměti.

V příkladu odkazují item a alias na tentýž objekt. Přepsaná metoda hashCode() záměrně vyvolá AssertionError, takže případné nechtěné volání bude viditelné. Program výsledky porovnává místo toho, aby vypisoval nepředvídatelnou hodnotu hashe; očekávaný výstup je true, true a 0, každý na samostatném řádku.

Příklady

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));
    }
}

Výsledek

true
true
0

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.

Zdroje