Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / Java

List.copyOf: plytká kópia zoznamu bez možnosti úprav

`List.copyOf` vráti snímku kolekcie bez možnosti úprav v poradí iterácie zdroja. Objekty prvkov zostávajú zdieľané a `null` nie je povolené.

Verzia: Java SE 21

Syntax

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

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

List.copyOf je statická metóda rozhrania java.util.List, dostupná od Javy 10. Prijíma Collection<? extends E>, nielen zoznam: prvky môžu byť typu E alebo jeho podtypu. Výsledný List<E> zachováva poradie iterácie zdrojovej kolekcie aj duplicitné prvky.

Pridanie, odstránenie alebo nahradenie prvku vo výsledku vyvolá UnsupportedOperationException. Neskoršie zmeny zdroja vrátane nahradenia prvku sa v snímke neprejavia. Naproti tomu Collections.unmodifiableList vracia pohľad bez možnosti úprav, v ktorom sú zmeny podkladového zoznamu viditeľné.

Kópia je plytká: snímka obsahuje odkazy na tie isté objekty. Zmena zdieľaného objektu StringBuilder sa preto prejaví aj v snímke. Objekty String sú nemenné, takže ich zdieľanie toto riziko neprináša. Ak potrebuješ nezávislý stav meniteľných prvkov, skopíruj aj samotné prvky.

Ak je kolekcia alebo niektorý jej prvok null, volanie pri vytváraní snímky vyvolá NullPointerException. Metóda môže opätovne použiť vhodný zoznam bez možnosti úprav, preto nepredpokladaj, že výsledkom je vždy nová inštancia.

Prí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ýsledok

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

Nahradenie `red` hodnotou `green` zmení iba zdroj a pridanie prvku do snímky zlyhá. Zdieľaný `StringBuilder` potom obsahuje `AB`. Po pridaní `null` do zdroja vyvolá ďalší pokus o vytvorenie snímky `NullPointerException`.

Súvisiace lekcie

  • Java · Lekcia 1 · Pokročilá · Verzia: 2
  • Java · Lekcia 44 · Stredne pokročilá · Verzia: 2

Zdroje