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 NumberFormatExceptionInteger.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
- 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()