Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / Java

List.copyOf: una copia superficial no modificable

`List.copyOf` devuelve una instantánea no modificable en el orden de iteración de la colección de origen. Comparte los objetos de los elementos y rechaza `null`.

Versión: Java SE 21

Sintaxis

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

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

List.copyOf es un método estático de la interfaz java.util.List, disponible desde Java 10. Acepta una Collection<? extends E>, no solo una lista: sus elementos pueden ser de tipo E o de un subtipo. Devuelve una List<E> que respeta el orden de iteración de la colección de origen y conserva los duplicados.

Añadir, eliminar o sustituir elementos en el resultado lanza UnsupportedOperationException. Los cambios posteriores en la colección de origen, como sustituir un elemento, no afectan a la instantánea. En cambio, Collections.unmodifiableList devuelve una vista no modificable que refleja los cambios de la lista subyacente.

La copia es superficial: la instantánea guarda referencias a los mismos objetos. Por eso, un cambio en un StringBuilder compartido se ve también en la instantánea. Los objetos String son inmutables, así que compartirlos no plantea ese riesgo. Si necesitas que el estado de los elementos mutables sea independiente, copia también esos elementos.

Si la propia colección o alguno de sus elementos es null, la llamada lanza NullPointerException al crear la instantánea. El método puede reutilizar una lista no modificable adecuada; no des por hecho que el resultado sea siempre una instancia nueva.

Ejemplos

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

Sustituir `red` por `green` solo cambia el origen, y añadir un elemento a la instantánea falla. El `StringBuilder` compartido pasa a contener `AB`. Tras añadir `null` al origen, el siguiente intento de crear una instantánea lanza `NullPointerException`.

Lecciones relacionadas

  • Java · Lección 1 · Avanzado · Versión: 2
  • Java · Lección 44 · Intermedio · Versión: 2

Fuentes