Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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

Źródła