CKTIS / Java
Collections.unmodifiableList — niemodyfikowalny widok listy
Metoda blokuje zapis przez zwrócony widok, ale nie zamraża listy źródłowej. Aby późniejsze zmiany źródła nie były widoczne, najpierw utwórz prywatną kopię.
Wersja: Java SE 21
Składnia
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 to statyczna metoda klasy java.util.Collections. Przyjmuje List<? extends T> i zwraca List<T>. Przekazanie null zamiast listy powoduje NullPointerException. Wynik nadal ma typ List: wywołania takie jak add i set kompilują się, ale próby modyfikacji przez widok, także przez jego iterator, kończą się w czasie wykonania wyjątkiem UnsupportedOperationException.
Odczyty z widoku korzystają z listy bazowej. Jeśli kod zachowa dostęp do tej listy i doda, usunie lub zastąpi element, kolejne odczyty z widoku pokażą zmianę. Użyj tego rozwiązania, gdy odbiorcy mają widzieć aktualny stan listy, ale nie powinni móc jej modyfikować przez udostępniony widok.
Jeśli skład i kolejność elementów mają pozostać takie jak w chwili kopiowania, użyj Collections.unmodifiableList(new ArrayList<>(source)). Nie udostępniaj modyfikowalnej kopii ani nie zmieniaj jej później. Wynik nadal jest widokiem, ale widokiem prywatnej kopii, a nie oryginału. Kopia jest płytka: stan współdzielonych, modyfikowalnych elementów nadal może się zmieniać. Sam widok nie dodaje synchronizacji.
Alternatywą jest List.copyOf(source): zwraca niemodyfikowalną listę, która nie odzwierciedla późniejszych zmian listy źródłowej, i nie wykonuje głębokiej kopii elementów. Odrzuca elementy null z wyjątkiem NullPointerException; widok prywatnej kopii utworzonej przez new ArrayList<>(source) je zachowuje.
Przykłady
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");
}
}
}Wynik
live: [X, B, C] snapshot: [A, B] UnsupportedOperationException
`source.set` i `source.add` zmieniają to, co odczytuje `live`, ale nie `snapshot`. Wywołanie `live.set` kompiluje się, lecz rzuca `UnsupportedOperationException`.
Powiązane lekcje
- Java · Lekcja 2 · Zaawansowany · Wersja: 2
- Java · Lekcja 21 · Zaawansowany · Wersja: 2