Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

List.copyOf: niemodyfikowalna, płytka kopia listy

`List.copyOf` zwraca niemodyfikowalną migawkę kolekcji w kolejności iteracji. Nie kopiuje samych obiektów i odrzuca `null`.

Wersja: Java SE 21

Składnia

static <E> List<E> copyOf(Collection<? extends E> coll)

List<E> snapshot = List.copyOf(coll);

List.copyOf to statyczna metoda interfejsu java.util.List, dostępna od Javy 10. Przyjmuje Collection<? extends E>, nie tylko listę: elementy mogą mieć typ E lub jego podtyp. Zwraca List<E> w kolejności iteracji kolekcji źródłowej, zachowując powtórzenia.

Dodawanie, usuwanie lub zastępowanie elementów w wyniku zgłasza UnsupportedOperationException. Późniejsze zmiany w źródle, w tym zastąpienie elementu, nie zmieniają migawki. Natomiast Collections.unmodifiableList zwraca niemodyfikowalny widok, przez który widać zmiany listy bazowej.

To kopia płytka: migawka przechowuje odwołania do tych samych obiektów. Zmiana stanu współdzielonego StringBuilder jest więc widoczna w migawce. Obiekty String są niemutowalne, więc współdzielenie ich nie niesie tego ryzyka. Jeśli potrzebujesz niezależnego stanu mutowalnych elementów, skopiuj również same elementy.

Jeśli kolekcja lub którykolwiek jej element to null, metoda zgłasza NullPointerException podczas tworzenia migawki. Metoda może ponownie użyć odpowiedniej niemodyfikowalnej listy; nie zakładaj, że wynik jest zawsze nową instancją.

Przykłady

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");
        }
    }
}

Wynik

source: [green, blue]
snapshot: [red, blue]
UnsupportedOperationException
shared element: AB
NullPointerException

Zastąpienie `red` przez `green` zmienia tylko źródło, a próba dodania do migawki kończy się wyjątkiem. Współdzielony `StringBuilder` zmienia się na `AB`. Po dodaniu `null` do źródła kolejna próba utworzenia migawki kończy się `NullPointerException`.

Powiązane lekcje

  • Java · Lekcja 1 · Zaawansowany · Wersja: 2
  • Java · Lekcja 44 · Średniozaawansowany · Wersja: 2

Źródła