CKTIS / Java
Collections.unmodifiableList — vista non modificabile di una lista
La vista impedisce le scritture senza congelare la lista di origine. Per non mostrare le modifiche successive all’originale, crea la vista su una copia privata.
Versione: Java SE 21
Sintassi
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 è un metodo statico di java.util.Collections. Accetta una List<? extends T> e restituisce un List<T>. Passare null al posto di una lista provoca una NullPointerException. Il risultato è ancora di tipo List: chiamate come add e set compilano, ma i tentativi di modificare la lista tramite la vista, anche tramite il suo iteratore, generano una UnsupportedOperationException in fase di esecuzione.
Le letture accedono alla lista sottostante. Se altro codice conserva l’accesso a quella lista e aggiunge, rimuove o sostituisce un elemento, le letture successive attraverso la vista mostrano il cambiamento. Usa questo approccio quando il chiamante deve vedere lo stato corrente della lista senza poterla modificare tramite il riferimento ricevuto.
Per conservare gli elementi presenti e il loro ordine al momento della copia, usa Collections.unmodifiableList(new ArrayList<>(source)). Non esporre la copia modificabile e non cambiarla in seguito. Il risultato è ancora una vista, ma della copia privata, non dell’originale. La copia è superficiale: gli elementi mutabili condivisi possono ancora cambiare stato. Il wrapper non aggiunge sincronizzazione.
List.copyOf(source) è un’alternativa: restituisce una lista non modificabile che non riflette le modifiche successive alla lista di origine e non esegue una copia profonda degli elementi. Rifiuta gli elementi null con una NullPointerException; una vista su una copia privata creata con new ArrayList<>(source) li conserva.
Esempi
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");
}
}
}Risultato
live: [X, B, C] snapshot: [A, B] UnsupportedOperationException
`source.set` e `source.add` cambiano ciò che legge `live`, ma non ciò che legge `snapshot`. `live.set` compila, ma genera una `UnsupportedOperationException`.
Lezioni correlate
- Java · Lezione 2 · Avanzato · Versione: 2
- Java · Lezione 21 · Avanzato · Versione: 2