Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / Java

Integer.valueOf: boxing explícito de um int

Converte um `int` primitivo num `Integer`, distingue o boxing da interpretação de texto e percebe por que motivo a identidade dos objetos não equivale à igualdade numérica.

Versão: Java SE 21

Sintaxe

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 é o nome de um método estático sobrecarregado da classe java.lang.Integer em Java SE 21. Integer.valueOf(int) devolve um Integer que representa o valor primitivo fornecido, sem interpretar texto. Integer.valueOf(42) faz o boxing de forma explícita, ao passo que Integer n = 42; usa autoboxing. Atribuir o resultado a uma variável do tipo Object não altera o tipo real do objeto: continua a ser um Integer.

As sobrecargas Integer.valueOf(String) e Integer.valueOf(String, int) interpretam primeiro um inteiro com sinal, respetivamente na base 10 e na base indicada. Texto inválido, null, um valor fora do intervalo de int ou uma base inválida provocam uma NumberFormatException. Se precisares de um resultado do tipo int, usa a sobrecarga correspondente de Integer.parseInt.

Integer.valueOf(int) garante a reutilização de instâncias para valores de -128 a 127, inclusive. Fora desse intervalo pode reutilizá-las, mas não contes com isso. Com duas referências Integer, == testa a identidade; usa equals para comparar os valores de dois objetos não nulos. Com um Integer e um int, == faz unboxing e compara os números. O unboxing de null provoca uma NullPointerException.

Num map aninhado, word.length() devolve um int. Integer.valueOf(word.length()) faz o boxing explícito desse comprimento, permitindo recolher cada grupo numa List<Integer>.

Exemplos

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

A variável `boxed`, do tipo `Object`, guarda uma referência para um `Integer` que representa `42`. A comparação imprime `true` porque ambas as chamadas devolvem a mesma instância em cache para `42`. O `map` interior transforma as palavras em comprimentos do tipo `Integer`: `4, 2` no primeiro grupo e `3` no segundo.

Lições relacionadas

  • Java · Lição 9 · Avançado · Versão: 2
  • Java · Lição 44 · Intermédio · Versão: 2

Fontes