WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Java

List.of und List.of() — nicht modifizierbare Listen

`List.of` erzeugt aus den angegebenen Elementen eine nicht modifizierbare Liste. `List.of()` liefert eine leere Liste. Keine der Überladungen akzeptiert `null`-Elemente.

Version: Java SE 21

Syntax

import java.util.List;

List<E> empty = List.of();
List<E> values = List.of(e1, e2);

// Factory method signatures (E is the element type):
// static <E> List<E> of()
// static <E> List<E> of(E e1, ..., E eN)  [one overload for each N from 1 to 10]
// static <E> List<E> of(E... elements)

List.of bezeichnet die seit Java 9 verfügbaren statischen Fabrikmethoden der Schnittstelle java.util.List. List.of() ist die Überladung ohne Argumente: Sie liefert eine leere, nicht modifizierbare Liste, die du übergeben kannst, wenn eine Liste erwartet wird, du aber keine Elemente hast. Bei List<String> empty = List.of(); leitet Java den Elementtyp aus dem deklarierten Typ der Variablen ab.

Es gibt Überladungen mit fester Parameterzahl für 1–10 Elemente und die Varargs-Überladung of(E... elements) für eine beliebige Anzahl. Die Reihenfolge der Argumente bleibt erhalten, und Duplikate sind erlaubt. Ist eines der übergebenen Elemente null, löst der Fabrikaufruf eine NullPointerException aus, statt eine Liste zurückzugeben.

Auf der zurückgegebenen Liste lösen add, remove und set eine UnsupportedOperationException aus, selbst wenn die Liste leer ist. Die Liste schützt ihre enthaltenen Objekte nicht vor Änderungen. Wenn du Elemente hinzufügen, entfernen oder ersetzen willst, erstelle mit new ArrayList<>(source) eine flache, modifizierbare Kopie.

Beispiele

import java.util.ArrayList;
import java.util.List;

public class ListOfDemo {
    public static void main(String[] args) {
        List<String> empty = List.of();
        List<String> colors = List.of("red", "blue", "red");
        System.out.println("Empty size: " + empty.size());
        System.out.println("Colors: " + String.join(", ", colors));

        try {
            colors.set(0, "green");
        } catch (UnsupportedOperationException expected) {
            System.out.println("UnsupportedOperationException");
        }

        try {
            List.of("red", null);
        } catch (NullPointerException expected) {
            System.out.println("NullPointerException");
        }

        List<String> editable = new ArrayList<>(empty);
        editable.add("green");
        System.out.println("Mutable copy: " + editable.get(0));
        System.out.println("Original size: " + empty.size());
    }
}

Ergebnis

Empty size: 0
Colors: red, blue, red
UnsupportedOperationException
NullPointerException
Mutable copy: green
Original size: 0

Das Beispiel zeigt die leere Liste, die unveränderte Reihenfolge samt Duplikaten und zwei verschiedene Ausnahmen. Das Hinzufügen eines Elements zur modifizierbaren Kopie ändert die leere Quellliste nicht.

Zugehörige Lektionen

  • Java · Lektion 67 · Grundlagen · Version: 2
  • Java · Lektion 34 · Mittlere Stufe · Version: 2
  • Java · Lektion 43 · Mittlere Stufe · Version: 2

Quellen