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

CKTIS / Java

Integer.valueOf : encapsuler explicitement un int

Convertissez un `int` primitif en `Integer`, distinguez l’encapsulation de l’analyse de texte et comprenez pourquoi comparer les références ne suffit pas à comparer les valeurs.

Version : Java SE 21

Syntaxe

public static Integer valueOf(int i)
public static Integer valueOf(String s) throws NumberFormatException
public static Integer valueOf(String s, int radix) throws NumberFormatException

Integer.valueOf désigne une méthode statique surchargée de la classe java.lang.Integer dans Java SE 21. Integer.valueOf(int) renvoie un objet Integer représentant la valeur primitive fournie, sans analyser de texte. Integer.valueOf(42) réalise une encapsulation explicite (boxing), tandis que Integer n = 42; utilise l’encapsulation automatique (autoboxing). Affecter le résultat à une variable de type Object ne change pas le type réel de l’objet : il reste un Integer.

Les surcharges Integer.valueOf(String) et Integer.valueOf(String, int) analysent d’abord un entier signé, respectivement en base 10 ou dans la base indiquée. Un texte invalide, null, une valeur hors de l’intervalle des int ou une base non valide provoque une NumberFormatException. Pour obtenir un int, utilisez la surcharge correspondante de Integer.parseInt.

Integer.valueOf(int) garantit la réutilisation des instances pour les valeurs de -128 à 127 inclus. Hors de cet intervalle, la réutilisation est possible, mais il ne faut pas compter dessus. Entre deux références Integer, == teste l’identité ; utilisez equals pour comparer les valeurs de deux objets non null. Entre un Integer et un int, == désencapsule le premier et compare les nombres. Désencapsuler null provoque une NullPointerException.

Dans un map imbriqué, word.length() renvoie un int. Integer.valueOf(word.length()) encapsule explicitement cette longueur, ce qui permet de recueillir chaque groupe dans une List<Integer>.

Exemples

import java.util.List;
import java.util.stream.Stream;

public class Main {
    public static void main(String[] args) {
        Object boxed = Integer.valueOf(42);
        System.out.println(boxed);
        System.out.println(boxed == Integer.valueOf(42));

        List<List<Integer>> lengths = Stream.of(List.of("Java", "SE"), List.of("API"))
                .map(group -> group.stream()
                        .map(word -> Integer.valueOf(word.length()))
                        .toList())
                .toList();

        System.out.println(lengths.get(0).get(0) + ", " + lengths.get(0).get(1));
        System.out.println(lengths.get(1).get(0));
    }
}

Résultat

42
true
4, 2
3

La variable `boxed` de type `Object` contient une référence à un `Integer` représentant `42`. La comparaison affiche `true`, car les deux appels renvoient la même instance mise en cache pour `42`. Le `map` interne transforme les mots en longueurs encapsulées : `4, 2` dans le premier groupe et `3` dans le second.

Leçons associées

  • Java · Leçon 9 · Avancé · Version : 2
  • Java · Leçon 44 · Intermédiaire · Version : 2

Sources