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

CKTIS / Java

List.copyOf: плитко копие на списък без възможност за промяна

`List.copyOf` връща моментна снимка без възможност за промяна, в реда на обхождане на изходната колекция. Обектите се споделят, а `null` не се допуска.

Версия: Java SE 21

Синтаксис

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

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

List.copyOf е статичен метод на интерфейса java.util.List, наличен от Java 10. Той приема Collection<? extends E>, а не само списък: елементите могат да са от тип E или негов подтип. Върнатият List<E> следва реда на обхождане на изходната колекция и запазва повтарящите се елементи.

Добавянето, премахването или замяната на елементи в резултата хвърля UnsupportedOperationException. По-късните промени в изходната колекция, включително замяната на елемент, не се отразяват в моментната снимка. За разлика от това Collections.unmodifiableList връща изглед, който не позволява директни промени, но отразява промените в списъка, върху който е създаден.

Копието е плитко: моментната снимка пази препратки към същите обекти. Затова промяна в споделен обект StringBuilder се вижда и в нея. Обектите String са неизменяеми и споделянето им не носи този риск. Ако ти трябва независимо състояние на изменяемите елементи, копирай и самите елементи.

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

Примери

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

Резултат

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

Замяната на `red` с `green` променя само изходната колекция, а добавянето към моментната снимка е неуспешно. Споделеният `StringBuilder` вече съдържа `AB`. След добавяне на `null` към изходната колекция следващият опит за създаване на моментна снимка хвърля `NullPointerException`.

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

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

Източници