CKTIS / Java
Collections.unmodifiableList — nicht änderbare Listenansicht
Die Ansicht verhindert Schreibzugriffe, ohne die Ursprungsliste einzufrieren. Soll sie spätere Änderungen nicht zeigen, stützen Sie sie auf eine private Kopie.
Version: Java SE 21
Syntax
public static <T> List<T> unmodifiableList(List<? extends T> list)
// Widok listy źródłowej / View of the source list
List<T> view = Collections.unmodifiableList(source);
// Widok prywatnej kopii / View of a private copy
List<T> snapshot = Collections.unmodifiableList(new ArrayList<>(source));Collections.unmodifiableList ist eine statische Methode von java.util.Collections. Sie nimmt eine List<? extends T> entgegen und gibt eine List<T> zurück. Wird statt einer Liste null übergeben, löst sie eine NullPointerException aus. Das Ergebnis hat weiterhin den Typ List: Aufrufe wie add und set lassen sich kompilieren, doch Änderungsversuche über die Ansicht oder ihren Iterator lösen zur Laufzeit eine UnsupportedOperationException aus.
Lesezugriffe erfolgen auf der zugrunde liegenden Liste. Kann anderer Code dort ein Element hinzufügen, entfernen oder ersetzen, zeigen spätere Lesezugriffe über die Ansicht diese Änderung. Verwenden Sie diese Variante, wenn Aufrufer den aktuellen Listenstand sehen, ihn aber nicht über die bereitgestellte Referenz ändern sollen.
Sollen die enthaltenen Elemente und ihre Reihenfolge dem Stand zum Kopierzeitpunkt entsprechen, verwenden Sie Collections.unmodifiableList(new ArrayList<>(source)). Geben Sie die änderbare Kopie nicht weiter und ändern Sie sie später nicht. Das Ergebnis ist weiterhin eine Ansicht, aber auf die private Kopie statt auf das Original. Die Kopie ist flach: Gemeinsam referenzierte veränderliche Elemente können ihren Zustand weiterhin ändern. Der Wrapper fügt keine Synchronisierung hinzu.
List.copyOf(source) ist eine Alternative: Die zurückgegebene Liste ist nicht änderbar, zeigt keine späteren Änderungen der Ursprungsliste und enthält keine tiefen Kopien der Elemente. Die Methode weist null-Elemente mit einer NullPointerException zurück; eine Ansicht auf eine mit new ArrayList<>(source) erstellte private Kopie behält sie bei.
Beispiele
import java.util.ArrayList;
import java.util.Collections;
import java.util.List;
public class Main {
public static void main(String[] args) {
List<String> source = new ArrayList<>(List.of("A", "B"));
List<String> live = Collections.unmodifiableList(source);
List<String> snapshot = Collections.unmodifiableList(new ArrayList<>(source));
source.set(0, "X");
source.add("C");
System.out.println("live: " + live);
System.out.println("snapshot: " + snapshot);
try {
live.set(0, "Y");
} catch (UnsupportedOperationException e) {
System.out.println("UnsupportedOperationException");
}
}
}Ergebnis
live: [X, B, C] snapshot: [A, B] UnsupportedOperationException
`source.set` und `source.add` ändern, was `live` liest, nicht aber, was `snapshot` liest. `live.set` lässt sich kompilieren, löst aber eine `UnsupportedOperationException` aus.
Zugehörige Lektionen
- Java · Lektion 2 · Fortgeschritten · Version: 2
- Java · Lektion 21 · Fortgeschritten · Version: 2