KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / Java

Collections.unmodifiableList — niet-wijzigbare weergave van een lijst

Blokkeer wijzigingen via de weergave zonder de bronlijst te bevriezen. Maak de weergave op basis van een privékopie als latere bronwijzigingen onzichtbaar moeten blijven.

Versie: Java SE 21

Syntax

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 is een statische methode van java.util.Collections. De methode accepteert een List<? extends T> en geeft een List<T> terug. Wie null doorgeeft in plaats van een lijst, krijgt een NullPointerException. Het resultaat heeft nog steeds het type List: aanroepen zoals add en set compileren, maar pogingen om de lijst via de weergave of haar iterator te wijzigen, leiden tijdens uitvoering tot een UnsupportedOperationException.

Bij het lezen wordt de onderliggende lijst geraadpleegd. Als andere code toegang tot die lijst behoudt en een element toevoegt, verwijdert of vervangt, is die wijziging bij volgende leesbewerkingen via de weergave zichtbaar. Gebruik dit patroon als aanroepers de actuele lijst moeten zien zonder die te kunnen wijzigen via de referentie die ze krijgen.

Gebruik Collections.unmodifiableList(new ArrayList<>(source)) om de elementen en hun volgorde op het kopieermoment vast te leggen. Geef de wijzigbare kopie niet door en wijzig die later ook niet. Het resultaat blijft een weergave, maar nu van de privékopie in plaats van het origineel. De kopie is oppervlakkig: gedeelde veranderlijke elementen kunnen nog van toestand veranderen. De wrapper voegt geen synchronisatie toe.

List.copyOf(source) is een alternatief: het resultaat is een niet-wijzigbare lijst die latere wijzigingen aan de bronlijst niet weerspiegelt en waarvan de elementen niet diep zijn gekopieerd. De methode weigert null-elementen met een NullPointerException; een weergave van een privékopie gemaakt met new ArrayList<>(source) behoudt ze.

Voorbeelden

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

Resultaat

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

`source.set` en `source.add` veranderen wat `live` leest, maar niet wat `snapshot` leest. `live.set` compileert, maar veroorzaakt een `UnsupportedOperationException`.

Gerelateerde lessen

  • Java · Les 2 · Gevorderd · Versie: 2
  • Java · Les 21 · Gevorderd · Versie: 2

Bronnen