Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

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 NumberFormatException

Integer.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