CKTIS / Java
Integer.valueOf: explizites Boxing eines int-Werts
Wandle einen primitiven `int` in ein `Integer`-Objekt um, unterscheide Boxing vom Einlesen von Text und erkenne, warum Objektidentität kein zuverlässiger Wertvergleich ist.
Version: Java SE 21
Syntax
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 ist der Name einer überladenen statischen Methode der Klasse java.lang.Integer in Java SE 21. Integer.valueOf(int) liefert ein Integer-Objekt für den übergebenen primitiven Wert, ohne Text zu parsen. Integer.valueOf(42) führt das Boxing explizit aus, während Integer n = 42; Autoboxing nutzt. Bei der Zuweisung an eine Variable vom Typ Object bleibt das Objekt ein Integer.
Die Überladungen Integer.valueOf(String) und Integer.valueOf(String, int) lesen zunächst eine vorzeichenbehaftete Ganzzahl ein, entweder zur Basis 10 oder zur angegebenen Basis. Ungültiger Text, null, ein Wert außerhalb des int-Bereichs oder eine unzulässige Basis führen zu einer NumberFormatException. Wenn du einen int als Ergebnis brauchst, verwende die entsprechende Überladung von Integer.parseInt.
Integer.valueOf(int) garantiert für Werte von -128 bis einschließlich 127 die Wiederverwendung von Instanzen. Außerhalb dieses Bereichs ist eine Wiederverwendung möglich, aber nicht garantiert. Bei zwei Integer-Referenzen prüft == die Identität; verwende equals, um die Werte zweier Nicht-null-Objekte zu vergleichen. Bei Integer und int führt == ein Unboxing durch und vergleicht die Zahlen. Unboxing von null löst eine NullPointerException aus.
In einem verschachtelten map liefert word.length() einen int. Integer.valueOf(word.length()) führt für diese Länge das Boxing explizit aus, sodass jede Gruppe als List<Integer> gesammelt werden kann.
Beispiele
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));
}
}Ergebnis
42 true 4, 2 3
Die `Object`-Variable `boxed` hält eine Referenz auf ein `Integer`-Objekt mit dem Wert `42`. Der Vergleich gibt `true` aus, weil beide Aufrufe für `42` dieselbe zwischengespeicherte Instanz liefern. Das innere `map` bildet die Wörter auf ihre Längen als `Integer` ab: `4, 2` in der ersten Gruppe und `3` in der zweiten.
Zugehörige Lektionen
- Java · Lektion 9 · Fortgeschritten · Version: 2
- Java · Lektion 44 · Mittlere Stufe · Version: 2
Quellen
- 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()