CKTIS / Java
List.copyOf: una copia superficiale non modificabile
`List.copyOf` restituisce un’istantanea non modificabile nell’ordine di iterazione della raccolta di origine. Condivide gli oggetti degli elementi e rifiuta `null`.
Versione: Java SE 21
Sintassi
static <E> List<E> copyOf(Collection<? extends E> coll)
List<E> snapshot = List.copyOf(coll);List.copyOf è un metodo statico dell’interfaccia java.util.List, disponibile da Java 10. Accetta una Collection<? extends E>, non soltanto una lista: gli elementi possono essere di tipo E o di un suo sottotipo. La List<E> risultante segue l’ordine di iterazione della raccolta di origine e conserva i duplicati.
Aggiungere, rimuovere o sostituire elementi nel risultato provoca una UnsupportedOperationException. Le modifiche successive alla raccolta di origine, compresa la sostituzione di un elemento, non si riflettono nell’istantanea. Collections.unmodifiableList restituisce invece una vista non modificabile che riflette le modifiche alla lista sottostante.
La copia è superficiale: l’istantanea contiene riferimenti agli stessi oggetti. Una modifica a uno StringBuilder condiviso è quindi visibile anche nell’istantanea. Gli oggetti String sono immutabili, perciò condividerli non comporta questo rischio. Se serve uno stato indipendente per gli elementi mutabili, copia anche gli elementi stessi.
Se la raccolta o uno dei suoi elementi è null, la chiamata lancia NullPointerException durante la creazione dell’istantanea. Il metodo può riutilizzare una lista non modificabile adatta: non dare per scontato che il risultato sia sempre una nuova istanza.
Esempi
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");
}
}
}Risultato
source: [green, blue] snapshot: [red, blue] UnsupportedOperationException shared element: AB NullPointerException
Sostituire `red` con `green` cambia solo l’origine, mentre aggiungere un elemento all’istantanea non riesce. Lo `StringBuilder` condiviso passa a contenere `AB`. Dopo aver aggiunto `null` all’origine, il tentativo successivo di creare un’istantanea lancia `NullPointerException`.
Lezioni correlate
- Java · Lezione 1 · Avanzato · Versione: 2
- Java · Lezione 44 · Intermedio · Versione: 2