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

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 Integer

Dans 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