Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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

Zdroje