WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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