Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / Java

System.identityHashCode — le code de hachage d’identité d’un objet

System.identityHashCode renvoie un code de hachage fondé sur l’identité de l’objet, sans appeler une méthode hashCode() redéfinie. Pour null, la méthode renvoie 0. Le résultat n’est pas un identifiant unique et ne remplace pas la comparaison de références avec ==.

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

Syntaxe

public static int identityHashCode(Object x)

System.identityHashCode(Object x) est une méthode statique qui renvoie un int : le code de hachage que renverrait l’implémentation par défaut de Object.hashCode() pour l’objet. Elle n’appelle pas la méthode hashCode() redéfinie par la classe de l’objet. Pour null, elle renvoie 0 au lieu de lever une exception.

Un appel ordinaire à x.hashCode() utilise l’implémentation choisie pour la classe réelle de l’objet ; celle-ci peut calculer un hachage à partir de son contenu. System.identityHashCode(x) concerne l’identité d’une instance précise, et non l’égalité de valeur définie par equals(). Deux objets égaux selon equals() ne sont pas nécessairement dotés de codes de hachage d’identité égaux.

Pour un même objet, le résultat reste cohérent au cours d’une exécution, mais il n’est pas nécessairement identique d’une exécution à l’autre. Des objets différents peuvent recevoir le même résultat : les collisions sont autorisées. Des résultats égaux ne prouvent donc pas que les références désignent le même objet ; utilisez == pour le vérifier. Ne considérez pas le résultat comme un identifiant unique, une clé persistante ou une adresse mémoire garantie.

Dans l’exemple, item et alias désignent le même objet. La méthode hashCode() redéfinie lève volontairement un AssertionError, ce qui rend visible tout appel accidentel. Le programme compare les résultats au lieu d’afficher la valeur de hachage imprévisible ; la sortie attendue est true, true et 0, chacun sur sa propre ligne.

Exemples

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

Résultat

true
true
0

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources