Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / Java

List.copyOf: uma cópia superficial não modificável

`List.copyOf` devolve um instantâneo não modificável pela ordem de iteração da coleção de origem. Partilha os objetos dos elementos e rejeita `null`.

Versão: Java SE 21

Sintaxe

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

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

List.copyOf é um método estático da interface java.util.List, disponível desde o Java 10. Aceita uma Collection<? extends E>, não apenas uma lista: os elementos podem ser do tipo E ou de um subtipo. A List<E> devolvida segue a ordem de iteração da coleção de origem e mantém os duplicados.

Adicionar, remover ou substituir elementos no resultado lança UnsupportedOperationException. Alterações posteriores na origem, incluindo a substituição de um elemento, não afetam o instantâneo. Em contraste, Collections.unmodifiableList devolve uma vista não modificável que reflete as alterações da lista subjacente.

A cópia é superficial: o instantâneo guarda referências para os mesmos objetos. Uma alteração num StringBuilder partilhado é, por isso, visível no instantâneo. Os objetos String são imutáveis e partilhá-los não traz esse risco. Se precisares de um estado independente para elementos mutáveis, copia também esses elementos.

Se a própria coleção ou algum dos seus elementos for null, a chamada lança NullPointerException ao criar o instantâneo. O método pode reutilizar uma lista não modificável adequada; não assumas que o resultado é sempre uma nova instância.

Exemplos

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

Resultado

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

Substituir `red` por `green` altera apenas a origem, e a tentativa de adicionar um elemento ao instantâneo falha. O `StringBuilder` partilhado passa a conter `AB`. Depois de adicionar `null` à origem, a tentativa seguinte de criar um instantâneo lança `NullPointerException`.

Lições relacionadas

  • Java · Lição 1 · Avançado · Versão: 2
  • Java · Lição 44 · Intermédio · Versão: 2

Fontes