CKTIS / Java
Varargs in Java: String... und T...
In Java SE 21 nimmt ein Varargs-Parameter einzelne Argumente oder ein vorhandenes Array entgegen. Bei `T...` kann durch Typlöschung eine Heap-Verunreinigung entstehen.
Version: Java SE 21
Syntax
static void labels(String... values) { /* values has type String[] */ }
static <T> int count(T... values) { return values.length; }In Java SE 21 kennzeichnet ... hinter dem Typ einen Varargs-Parameter. Eine Methode oder ein Konstruktor darf höchstens einen solchen Parameter haben, und er muss an letzter Stelle stehen. Im Methodenrumpf hat String... values den Typ String[]; in einer generischen Methode mit Typparameter <T> hat T... values den Typ T[].
Bei einem Aufruf mit variabler Argumentzahl veranlasst der Compiler, dass die letzten Argumente in ein neues Array gepackt werden. labels() erhält ein leeres Array, nicht null. Passt der Aufruf ohne Verpacken, wird ein kompatibles Array ohne Kopie übergeben; Änderungen an seinen Elementen sind für den Aufrufer sichtbar. Bei der gezeigten Methode übergeben labels(null) und labels((String[]) null) eine Nullreferenz statt eines Arrays. Der Zugriff auf length würde eine NullPointerException auslösen. labels((String) null) übergibt ein Array mit einem Null-Element.
Die Überladungsauflösung sucht zuerst ohne Verpacken nach einer passenden Methode: zunächst ohne Boxing und Unboxing, danach mit beiden. Nur wenn keine der beiden Phasen eine anwendbare Methode findet, kommt das Verpacken infrage. Eine Varargs-Methode kann also schon in einer Phase mit fester Argumentzahl ausgewählt werden. labels(String...) und labels(String[]) haben dieselbe Signatur und sind keine getrennten Überladungen.
String ist reifizierbar: Sein Typ ist zur Laufzeit vollständig verfügbar. T ist nicht reifizierbar; beim Verpacken wird das Array mit der gelöschten Form des für den Aufruf ermittelten Arraytyps erzeugt. Der Compiler meldet an der Deklaration eine unchecked-Warnung und kann auch beim Aufruf warnen. Wird das Array über eine Referenz vom Typ Object[] angesprochen, kann ein Schreibzugriff generische Typgarantien verletzen. Diese Heap-Verunreinigung kann sich erst beim Lesen als ClassCastException zeigen.
@SafeVarargs ist eine Zusicherung des Autors, keine Laufzeitprüfung. Die Annotation unterdrückt diese Warnungen an der Deklaration und an den Aufrufstellen. Sie ist bei Varargs-Konstruktoren und bei static, final oder private deklarierten Varargs-Methoden erlaubt. Prüfe vorher, dass das Array weder unsicher verwendet noch unsicher weitergegeben wird.
Beispiele
import java.util.Arrays;
import java.util.List;
public class VarargsDemo {
static void labels(String... values) {
System.out.println(Arrays.toString(values));
}
@SafeVarargs
static <T> int count(T... values) {
return values.length;
}
public static void main(String[] args) {
labels();
labels("red", "blue");
labels(new String[]{"green"});
labels((String) null);
labels((String[]) null);
System.out.println(count(List.of("red", "blue"), List.of("green")));
}
}Ergebnis
[] [red, blue] [green] [null] null 2
`[]` ist ein leeres Array, `[null]` ein Array mit einem Null-Element und `null` bedeutet, dass kein Array vorliegt. `count` liest nur die Arraylänge und zählt damit zwei Listen, nicht drei Zeichenketten.
Zugehörige Lektionen
- Java · Lektion 3 · Fortgeschritten · Version: 2
- Java · Lektion 14 · Fortgeschritten · Version: 2
Quellen
- Java Language Specification, Java SE 21 — §8.4.1 Formal Parameters
- Java Language Specification, Java SE 21 — §8.4.2 Method Signature
- Java Language Specification, Java SE 21 — §15.12.2 Compile-Time Step 2: Determine Method Signature
- Java Language Specification, Java SE 21 — §15.12.4.2 Evaluate Arguments
- Java Language Specification, Java SE 21 — §4.7 Reifiable Types
- Java Language Specification, Java SE 21 — §4.12.2 Variables of Reference Type
- Java SE 21 API — SafeVarargs
- Java SE 21 API — Arrays.toString(Object[])
- JDK 21 Tool Specifications — The javac Command