CKTIS / Java
Integer.valueOf: jawny boxing wartości int
Zamień prymitywną wartość `int` na obiekt `Integer`, odróżnij boxing od parsowania tekstu i dowiedz się, kiedy porównanie referencji daje mylący wynik.
Wersja: Java SE 21
Składnia
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 to nazwa przeciążonej metody statycznej klasy java.lang.Integer w Java SE 21. Integer.valueOf(int) zwraca obiekt Integer reprezentujący przekazaną wartość prymitywną, bez parsowania tekstu. Zapis Integer.valueOf(42) jawnie wykonuje boxing, natomiast Integer n = 42; korzysta z autoboxingu. Przypisanie wyniku do zmiennej typu Object nie zmienia typu obiektu: nadal jest nim Integer.
Przeciążenia Integer.valueOf(String) i Integer.valueOf(String, int) najpierw parsują liczbę całkowitą ze znakiem, odpowiednio w systemie dziesiętnym i o podanej podstawie. Nieprawidłowy tekst, null, wartość spoza zakresu int lub niedozwolona podstawa powodują NumberFormatException. Jeśli potrzebujesz wyniku typu int, użyj odpowiedniego przeciążenia Integer.parseInt.
Integer.valueOf(int) gwarantuje współdzielenie instancji dla wartości od -128 do 127 włącznie. Poza tym zakresem metoda może współdzielić instancje, ale nie wolno na tym polegać. Dla dwóch referencji Integer operator == sprawdza tożsamość; do porównania wartości niepustych obiektów użyj equals. W porównaniu Integer z int operator == powoduje unboxing i porównuje liczby. Unboxing null powoduje NullPointerException.
W zagnieżdżonym map metoda word.length() zwraca int. Wywołanie Integer.valueOf(word.length()) jawnie zamienia długość na Integer, dzięki czemu każdą grupę można zebrać jako List<Integer>.
Przykłady
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));
}
}Wynik
42 true 4, 2 3
Zmienna `boxed` typu `Object` przechowuje referencję do obiektu `Integer` o wartości `42`. Porównanie wypisuje `true`, ponieważ oba wywołania zwracają dla `42` tę samą instancję z pamięci podręcznej. Wewnętrzny `map` zamienia słowa na opakowane długości: `4, 2` w pierwszej grupie i `3` w drugiej.
Powiązane lekcje
- Java · Lekcja 9 · Zaawansowany · Wersja: 2
- Java · Lekcja 44 · Średniozaawansowany · Wersja: 2
Źródła
- 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()