WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Java

List.copyOf: eine nicht modifizierbare, flache Listenkopie

`List.copyOf` liefert eine nicht modifizierbare Momentaufnahme in der Iterationsreihenfolge der Quell-Collection. Die Elementobjekte werden geteilt; `null` ist nicht erlaubt.

Version: Java SE 21

Syntax

static <E> List<E> copyOf(Collection<? extends E> coll)

List<E> snapshot = List.copyOf(coll);

List.copyOf ist eine statische Methode der Schnittstelle java.util.List und seit Java 10 verfügbar. Sie akzeptiert eine Collection<? extends E>, nicht nur eine Liste: Die Elemente können vom Typ E oder einem Untertyp sein. Die resultierende List<E> übernimmt die Iterationsreihenfolge der Quelle und behält Duplikate bei.

Das Hinzufügen, Entfernen oder Ersetzen von Elementen im Ergebnis löst UnsupportedOperationException aus. Spätere Änderungen an der Quelle, etwa das Ersetzen eines Elements, wirken sich nicht auf die Momentaufnahme aus. Collections.unmodifiableList liefert dagegen eine nicht modifizierbare Sicht, in der Änderungen an der zugrunde liegenden Liste sichtbar bleiben.

Die Kopie ist flach: Die Momentaufnahme enthält Referenzen auf dieselben Elementobjekte. Änderungen an einem gemeinsam genutzten StringBuilder sind daher auch dort sichtbar. String-Objekte sind unveränderlich, sodass dieses Risiko bei ihnen nicht besteht. Wenn veränderliche Elemente einen unabhängigen Zustand haben sollen, kopiere auch die Elemente selbst.

Ist die Collection selbst oder eines ihrer Elemente null, löst der Aufruf beim Erstellen der Momentaufnahme NullPointerException aus. Die Methode kann eine geeignete nicht modifizierbare Liste wiederverwenden. Gehe daher nicht davon aus, dass das Ergebnis immer eine neue Instanz ist.

Beispiele

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

public class Main {
    public static void main(String[] args) {
        List<String> source = new ArrayList<>(List.of("red", "blue"));
        List<String> snapshot = List.copyOf(source);
        source.set(0, "green");
        System.out.println("source: " + source);
        System.out.println("snapshot: " + snapshot);

        try {
            snapshot.add("yellow");
        } catch (UnsupportedOperationException e) {
            System.out.println("UnsupportedOperationException");
        }

        StringBuilder shared = new StringBuilder("A");
        List<StringBuilder> mutableSnapshot = List.copyOf(List.of(shared));
        shared.append("B");
        System.out.println("shared element: " + mutableSnapshot.get(0));

        source.add(null);
        try {
            List.copyOf(source);
        } catch (NullPointerException e) {
            System.out.println("NullPointerException");
        }
    }
}

Ergebnis

source: [green, blue]
snapshot: [red, blue]
UnsupportedOperationException
shared element: AB
NullPointerException

Das Ersetzen von `red` durch `green` ändert nur die Quelle. Das Hinzufügen zur Momentaufnahme scheitert. Der gemeinsam genutzte `StringBuilder` ändert sich zu `AB`. Nach dem Hinzufügen von `null` zur Quelle löst der nächste Kopierversuch `NullPointerException` aus.

Zugehörige Lektionen

  • Java · Lektion 1 · Fortgeschritten · Version: 2
  • Java · Lektion 44 · Mittlere Stufe · Version: 2

Quellen