Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Java

System.identityHashCode — codice hash di identità di un oggetto

System.identityHashCode restituisce un codice hash basato sull’identità dell’oggetto, senza usare un metodo hashCode() sovrascritto. Per null restituisce 0. Il risultato non è un identificatore univoco e non sostituisce il confronto dei riferimenti con ==.

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

Sintassi

public static int identityHashCode(Object x)

System.identityHashCode(Object x) è un metodo statico che restituisce un int: il codice hash che l’implementazione predefinita di Object.hashCode() restituirebbe per l’oggetto. Non invoca il metodo hashCode() sovrascritto dalla classe dell’oggetto. Per null, restituisce 0 invece di generare un’eccezione.

Una normale chiamata a x.hashCode() usa l’implementazione selezionata per la classe effettiva dell’oggetto; questa può calcolare un hash a partire dal suo contenuto. System.identityHashCode(x) riguarda l’identità di una specifica istanza, non l’uguaglianza di valore definita da equals(). Due oggetti uguali secondo equals() non devono necessariamente avere codici hash di identità uguali.

Per lo stesso oggetto, il risultato rimane costante durante una singola esecuzione, ma non è detto che sia uguale nelle esecuzioni successive. Oggetti diversi possono ricevere lo stesso risultato: le collisioni sono ammesse. Risultati uguali, quindi, non dimostrano che i riferimenti puntino allo stesso oggetto; per verificarlo, usa ==. Non considerare il risultato un identificatore univoco, una chiave persistente o un indirizzo di memoria garantito.

Nell’esempio, item e alias fanno riferimento allo stesso oggetto. Il metodo hashCode() sovrascritto genera intenzionalmente un AssertionError, rendendo visibile un’eventuale chiamata accidentale. Il programma confronta i risultati invece di stampare il valore hash imprevedibile; l’output previsto è true, true e 0, ciascuno su una riga distinta.

Esempi

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

Risultato

true
true
0

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti