Чем полезен List.copyOf() в Java?

Иногда объект получает список извне и сохраняет его в поле:

public Order(List<String> items) {
    this.items = items;
}

На первый взгляд всё нормально. Но если внешний код потом изменит список, изменится и состояние Order:

List<String> source = new ArrayList<>();
source.add("book");

Order order = new Order(source);
source.add("phone");

Теперь внутри order тоже может оказаться новый элемент, хотя сам Order его не добавлял.

Чтобы защититься, можно сделать копию:

this.items = List.copyOf(items);

Теперь объект хранит собственный неизменяемый снимок списка:

public Order(List<String> items) {
    this.items = List.copyOf(items);
}

Если исходный список изменится позже, поле внутри Order уже не поменяется:

source.add("phone");

// order всё ещё хранит старый набор

И сам список внутри Order нельзя случайно изменить:

order.items().add("tablet"); // UnsupportedOperationException

Обычно такой список удобно возвращать наружу:

public List<String> items() {
    return items;
}

Потому что вызывающий код не сможет незаметно изменить внутреннее состояние объекта.

Важно: List.copyOf() не принимает null-элементы:

List.copyOf(List.of("a", null)); // NullPointerException

List.copyOf() полезен для защитного копирования. Он помогает не отдавать внутреннее состояние объекта под управление внешнего кода.

👉 Java Ready | #совет