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