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

CKTIS / Java

Collections.unmodifiableList — vista não modificável de uma lista

A vista impede a escrita sem congelar a lista de origem. Para que as alterações posteriores à origem não apareçam na vista, crie-a sobre uma cópia privada.

Versão: Java SE 21

Sintaxe

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 é um método estático de java.util.Collections. Recebe uma List<? extends T> e devolve uma List<T>. Passar null em vez de uma lista provoca uma NullPointerException. O resultado continua a ser do tipo List: chamadas como add e set compilam, mas as tentativas de modificar a lista através da vista, incluindo através do seu iterador, lançam UnsupportedOperationException em tempo de execução.

As leituras consultam a lista subjacente. Se outro código mantiver acesso a essa lista e adicionar, remover ou substituir um elemento, as leituras seguintes através da vista mostram a alteração. Use este padrão quando quem chama o método deve ver o estado atual da lista, mas não a deve poder modificar através da referência recebida.

Para preservar os elementos presentes e a sua ordem no momento da cópia, use Collections.unmodifiableList(new ArrayList<>(source)). Não exponha a cópia modificável nem a altere posteriormente. O resultado continua a ser uma vista, mas da cópia privada e não da lista original. A cópia é superficial: os elementos mutáveis partilhados ainda podem mudar de estado. O invólucro não acrescenta sincronização.

List.copyOf(source) é outra opção: devolve uma lista não modificável que não reflete alterações posteriores à lista de origem e não faz uma cópia profunda dos elementos. Rejeita elementos null com uma NullPointerException; uma vista sobre uma cópia privada criada com new ArrayList<>(source) conserva-os.

Exemplos

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` e `source.add` alteram o que `live` lê, mas não o que `snapshot` lê. `live.set` compila, mas lança `UnsupportedOperationException`.

Lições relacionadas

  • Java · Lição 2 · Avançado · Versão: 2
  • Java · Lição 21 · Avançado · Versão: 2

Fontes