CKTIS / Java
Collections.unmodifiableList — nemodifikovatelný pohled na seznam
Pohled blokuje zápis, ale nezmrazí zdrojový seznam. Pokud nemá odrážet pozdější změny zdroje, vytvořte jej nad soukromou kopií.
Verze: Java SE 21
Syntaxe
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 je statická metoda třídy java.util.Collections. Přijímá List<? extends T> a vrací List<T>. Předání null místo seznamu vyvolá NullPointerException. Výsledek má stále typ List: volání jako add a set lze zkompilovat, ale pokus o změnu seznamu přes pohled, včetně změny přes jeho iterátor, za běhu vyvolá UnsupportedOperationException.
Čtení přes pohled používá podkladový seznam. Pokud si kód zachová přístup k tomuto seznamu a přidá, odebere nebo nahradí prvek, následná čtení přes pohled změnu ukážou. Tento postup použijte, pokud má volající vidět aktuální stav seznamu, ale nemá mít možnost seznam měnit přes poskytnutou referenci.
Chcete-li zachovat prvky seznamu i jejich pořadí z okamžiku kopírování, použijte Collections.unmodifiableList(new ArrayList<>(source)). Zapisovatelnou kopii nezpřístupňujte ani ji později neměňte. Výsledkem je stále pohled, ale na soukromou kopii, nikoli na originál. Kopie je mělká: sdílené měnitelné prvky mohou stále měnit svůj stav. Obal nepřidává synchronizaci.
Další možností je List.copyOf(source): vrací nemodifikovatelný seznam, který neodráží pozdější změny zdrojového seznamu, a nepořizuje hluboké kopie prvků. Prvky null odmítá výjimkou NullPointerException; pohled na soukromou kopii vytvořenou pomocí new ArrayList<>(source) je zachová.
Příklady
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");
}
}
}Výsledek
live: [X, B, C] snapshot: [A, B] UnsupportedOperationException
`source.set` a `source.add` změní to, co čte `live`, ale ne to, co čte `snapshot`. Volání `live.set` lze zkompilovat, ale vyvolá `UnsupportedOperationException`.
Související lekce
- Java · Lekce 2 · Pokročilá · Verze: 2
- Java · Lekce 21 · Pokročilá · Verze: 2