CKTIS / Java
Integer.valueOf: convertir explícitamente un int en un Integer
Convierte un `int` primitivo en un `Integer`, distingue el boxing del análisis de texto y descubre por qué la identidad del objeto no equivale a la igualdad numérica.
Versión: Java SE 21
Sintaxis
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 es el nombre de un método estático sobrecargado de java.lang.Integer en Java SE 21. Integer.valueOf(int) devuelve un Integer que representa el valor primitivo recibido, sin analizar texto. Integer.valueOf(42) hace explícita la conversión a objeto (boxing), mientras que Integer n = 42; usa autoboxing. Asignar el resultado a una variable de tipo Object no cambia el tipo real del objeto: sigue siendo un Integer.
Las sobrecargas Integer.valueOf(String) e Integer.valueOf(String, int) primero interpretan un entero con signo, en base 10 y en la base indicada, respectivamente. Un texto no válido, null, un valor fuera del rango de int o una base no válida provocan una NumberFormatException. Si necesitas un resultado de tipo int, usa la sobrecarga correspondiente de Integer.parseInt.
Integer.valueOf(int) garantiza que se reutilizan las instancias para valores de -128 a 127, ambos incluidos. Fuera de ese rango puede reutilizarlas, pero no debes darlo por hecho. Entre dos referencias Integer, == comprueba la identidad; usa equals para comparar los valores de dos objetos no nulos. Entre un Integer y un int, == convierte el objeto a int (unboxing) y compara los números. Hacer unboxing de null provoca una NullPointerException.
En un map anidado, word.length() devuelve un int. Integer.valueOf(word.length()) convierte explícitamente esa longitud en un Integer, lo que permite recopilar cada grupo como una List<Integer>.
Ejemplos
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));
}
}Resultado
42 true 4, 2 3
La variable `boxed`, de tipo `Object`, contiene una referencia a un `Integer` que representa `42`. La comparación imprime `true` porque ambas llamadas devuelven la misma instancia almacenada en caché para `42`. El `map` interno transforma las palabras en longitudes de tipo `Integer`: `4, 2` en el primer grupo y `3` en el segundo.
Lecciones relacionadas
- Java · Lección 9 · Avanzado · Versión: 2
- Java · Lección 44 · Intermedio · Versión: 2
Fuentes
- 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()