CKTIS / Java
Integer.hashCode : valeur primitive ou objet Integer
Utilisez `Integer.hashCode(id)` pour un `int` primitif et `boxed.hashCode()` pour un objet `Integer`. Les deux méthodes renvoient la valeur numérique elle-même comme code de hachage.
Version : Java SE 21
Syntaxe
java.lang.Integer (Java SE 21)
public static int hashCode(int value) // Integer.hashCode(id), where id is an int
public int hashCode() // boxed.hashCode(), where boxed is an IntegerDans java.lang.Integer, le nom Integer.hashCode désigne deux méthodes. La méthode statique Integer.hashCode(int) existe depuis Java 8. Si id est de type int, Integer.hashCode(id) renvoie exactement id sans nécessiter d’encapsulation dans un objet. Le résultat peut être négatif.
La méthode d’instance sans argument Integer.hashCode() redéfinit Object.hashCode(). L’appel boxed.hashCode() renvoie la valeur int contenue dans boxed. Un appel sur une référence null déclenche une NullPointerException. Passer à la méthode statique une variable de type Integer valant null déclenche aussi cette exception, mais lors du déballage en int.
Si votre classe compare un champ int id dans equals, utilisez Integer.hashCode(id) comme contribution de ce champ au code de hachage. Deux objets égaux doivent avoir le même code de hachage ; en revanche, un même code ne prouve pas leur égalité. Pour Integer, equals exige que l’autre objet soit aussi un Integer contenant la même valeur.
Cette méthode ne masque pas un identifiant : elle le renvoie tel quel. Ce n’est pas une fonction de hachage cryptographique.
Exemples
public class IntegerHashCodeDemo {
public static void main(String[] args) {
int id = -42;
Integer boxed = Integer.valueOf(id);
System.out.println(Integer.hashCode(id));
System.out.println(boxed.hashCode());
}
}
Résultat
-42 -42
La première ligne provient de l’appel statique avec un `int`, la seconde de l’appel d’instance sur un `Integer`. Les deux affichent `-42`, car le code de hachage est égal à la valeur.
Leçons associées
- Java · Leçon 5 · Avancé · Version : 2
- Java · Leçon 17 · Avancé · Version : 2
- Java · Leçon 5 · Intermédiaire · Version : 2
Sources
- Integer (Java SE 21 & JDK 21) — hashCode(int)
- Integer (Java SE 21 & JDK 21) — hashCode()
- Integer (Java SE 21 & JDK 21) — equals(Object)
- Object (Java SE 21 & JDK 21) — hashCode() contract
- The Java Language Specification, Java SE 21 Edition — §5.1.8 Unboxing Conversion
- The java Command — Using Source-File Mode to Launch Single-File Source-Code Programs