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

CKTIS / Java

List.copyOf: mělká kopie seznamu bez možnosti úprav

`List.copyOf` vrací snímek kolekce bez možnosti úprav v pořadí iterace zdroje. Objekty prvků zůstávají sdílené a `null` není povoleno.

Verze: Java SE 21

Syntaxe

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

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

List.copyOf je statická metoda rozhraní java.util.List, dostupná od Javy 10. Přijímá Collection<? extends E>, nejen seznam: prvky mohou být typu E nebo jeho podtypu. Vrací List<E> v pořadí, v jakém se prochází zdrojová kolekce, a zachovává duplicity.

Přidání, odebrání nebo nahrazení prvku ve výsledku vyvolá UnsupportedOperationException. Pozdější změny zdroje, včetně nahrazení prvku, se ve snímku neprojeví. Oproti tomu Collections.unmodifiableList vrací pohled bez možnosti úprav, ve kterém jsou změny podkladového seznamu vidět.

Kopie je mělká: snímek obsahuje odkazy na stejné objekty. Změna sdíleného objektu StringBuilder je proto vidět i ve snímku. Objekty String jsou neměnné, takže jejich sdílení toto riziko nepřináší. Pokud potřebuješ nezávislý stav měnitelných prvků, zkopíruj i samotné prvky.

Pokud je kolekce nebo některý její prvek null, volání při vytváření snímku vyvolá NullPointerException. Metoda může znovu použít vhodný seznam bez možnosti úprav, proto nepředpokládej, že výsledkem je vždy nová instance.

Příklady

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");
        }
    }
}

Výsledek

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

Nahrazení `red` hodnotou `green` změní jen zdroj. Přidání prvku do snímku selže. Sdílený `StringBuilder` pak obsahuje `AB`. Po přidání `null` do zdroje vyvolá další pokus o vytvoření snímku `NullPointerException`.

Související lekce

  • Java · Lekce 1 · Pokročilá · Verze: 2
  • Java · Lekce 44 · Středně pokročilá · Verze: 2

Zdroje