Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / Java

Collections.unmodifiableList — vue non modifiable d’une liste

Bloquez les écritures via une vue sans figer la liste source. Pour que les modifications ultérieures de la source restent invisibles, créez la vue sur une copie privée.

Version : Java SE 21

Syntaxe

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 est une méthode statique de java.util.Collections. Elle prend une List<? extends T> et renvoie une List<T>. Passer null à la place d’une liste déclenche une NullPointerException. Le résultat est toujours de type List : les appels comme add et set compilent, mais toute tentative de modification via la vue, y compris via son itérateur, déclenche une UnsupportedOperationException à l’exécution.

Les lectures se font dans la liste sous-jacente. Si du code conserve un accès à cette liste et ajoute, supprime ou remplace un élément, les lectures suivantes via la vue reflètent la modification. Utilisez cette approche si le code appelant doit voir l’état actuel de la liste sans pouvoir la modifier via la référence fournie.

Pour conserver les éléments présents et leur ordre au moment de la copie, utilisez Collections.unmodifiableList(new ArrayList<>(source)). N’exposez pas la copie modifiable et ne la modifiez pas par la suite. Le résultat reste une vue, mais sa liste sous-jacente est la copie privée, pas l’original. La copie est superficielle : les éléments mutables partagés peuvent encore changer d’état. L’enveloppe n’ajoute aucune synchronisation.

Autre possibilité : List.copyOf(source) renvoie une liste non modifiable qui ne reflète pas les modifications ultérieures de la liste source, sans effectuer de copie profonde des éléments. Cette méthode rejette les éléments null avec une NullPointerException ; une vue sur une copie privée créée avec new ArrayList<>(source) les conserve.

Exemples

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");
        }
    }
}

Résultat

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

`source.set` et `source.add` changent ce que lit `live`, mais pas ce que lit `snapshot`. `live.set` compile, mais déclenche une `UnsupportedOperationException`.

Leçons associées

  • Java · Leçon 2 · Avancé · Version : 2
  • Java · Leçon 21 · Avancé · Version : 2

Sources