База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / Java

Collections.unmodifiableList — изглед на списък без операции за промяна

Изгледът забранява промените през върнатата референция, без да замразява изходния списък. За да не се виждат по-късните промени в него, създайте изглед към частно копие.

Версия: Java SE 21

Синтаксис

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 е статичен метод на java.util.Collections. Той приема List<? extends T> и връща List<T>. Подаването на null вместо списък води до NullPointerException. Резултатът остава от тип List: извиквания като add и set се компилират, но опитите за промяна на списъка през изгледа, включително през неговия итератор, хвърлят UnsupportedOperationException по време на изпълнение.

Четенето през изгледа използва списъка, на който той се основава. Ако друг код запази достъп до този списък и добави, премахне или замени елемент, следващите четения през изгледа ще покажат промяната. Използвайте този подход, когато извикващият код трябва да вижда текущото състояние на списъка, но не бива да може да го променя през предоставената референция.

За да запазите елементите и реда им към момента на копиране, използвайте Collections.unmodifiableList(new ArrayList<>(source)). Не предоставяйте достъп до изменяемото копие и не го променяйте по-късно. Резултатът все още е изглед, но към частното копие, а не към оригинала. Копието е плитко: споделените изменяеми елементи все още могат да променят състоянието си. Обвивката не добавя синхронизация.

Друга възможност е List.copyOf(source): връща списък, който не може да се променя, не отразява последващи промени в изходния списък и не копира елементите в дълбочина. Методът отхвърля елементи null с NullPointerException; изглед към частно копие, създадено с new ArrayList<>(source), ги запазва.

Примери

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

Резултат

live: [X, B, C]
snapshot: [A, B]
UnsupportedOperationException

`source.set` и `source.add` променят това, което `live` прочита, но не и това, което `snapshot` прочита. `live.set` се компилира, но хвърля `UnsupportedOperationException`.

Свързани уроци

  • Java · Урок 2 · Напреднало · Версия: 2
  • Java · Урок 21 · Напреднало · Версия: 2

Източници