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