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.