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

CKTIS / Java

Collections.unmodifiableList — vista no modificable de una lista

Impide las escrituras a través de la vista sin congelar la lista de origen. Para que los cambios posteriores del origen no se reflejen, crea la vista sobre una copia privada.

Versión: Java SE 21

Sintaxis

public static <T> List<T> unmodifiableList(List<? extends T> list)

// Widok listy źródłowej / View of the source list
List<T> view = Collections.unmodifiableList(source);

// Widok prywatnej kopii / View of a private copy
List<T> snapshot = Collections.unmodifiableList(new ArrayList<>(source));

Collections.unmodifiableList es un método estático de java.util.Collections. Recibe una List<? extends T> y devuelve una List<T>. Pasar null en lugar de una lista provoca una NullPointerException. El resultado sigue siendo de tipo List: llamadas como add y set compilan, pero los intentos de modificar la lista a través de la vista, incluso mediante su iterador, lanzan UnsupportedOperationException en tiempo de ejecución.

Las lecturas consultan la lista subyacente. Si otro código conserva acceso a esa lista y añade, elimina o sustituye un elemento, las lecturas posteriores a través de la vista muestran el cambio. Usa este patrón cuando quienes llaman al método deban ver el estado actual de la lista sin poder modificarla con la referencia que reciben.

Para conservar los elementos y su orden en el momento de la copia, usa Collections.unmodifiableList(new ArrayList<>(source)). No expongas la copia modificable ni la cambies más adelante. El resultado sigue siendo una vista, pero de la copia privada, no de la lista original. La copia es superficial: los elementos mutables compartidos aún pueden cambiar de estado. La envoltura no añade sincronización.

List.copyOf(source) es otra opción: devuelve una lista no modificable que no refleja los cambios posteriores de la lista de origen y no realiza una copia profunda de los elementos. Rechaza los elementos null con una NullPointerException; una vista sobre una copia privada creada con new ArrayList<>(source) sí los conserva.

Ejemplos

import java.util.ArrayList;
import java.util.Collections;
import java.util.List;

public class Main {
    public static void main(String[] args) {
        List<String> source = new ArrayList<>(List.of("A", "B"));
        List<String> live = Collections.unmodifiableList(source);
        List<String> snapshot = Collections.unmodifiableList(new ArrayList<>(source));

        source.set(0, "X");
        source.add("C");
        System.out.println("live: " + live);
        System.out.println("snapshot: " + snapshot);

        try {
            live.set(0, "Y");
        } catch (UnsupportedOperationException e) {
            System.out.println("UnsupportedOperationException");
        }
    }
}

Resultado

live: [X, B, C]
snapshot: [A, B]
UnsupportedOperationException

`source.set` y `source.add` cambian lo que lee `live`, pero no lo que lee `snapshot`. `live.set` compila, pero lanza `UnsupportedOperationException`.

Lecciones relacionadas

  • Java · Lección 2 · Avanzado · Versión: 2
  • Java · Lección 21 · Avanzado · Versión: 2

Fuentes