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