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 NumberFormatExceptionInteger.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
- Java SE 21 API — Integer.valueOf(int)
- Java SE 21 API — Integer.valueOf(String)
- Java SE 21 API — Integer.valueOf(String, int)
- Java SE 21 API — Integer.equals(Object)
- Java Language Specification, Java SE 21 — §5.1.7 Boxing Conversion and §5.1.8 Unboxing Conversion
- Java Language Specification, Java SE 21 — §15.21 Equality Operators
- Java SE 21 API — Stream.map(Function)
- Java SE 21 API — Stream.toList()