Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / Java

Collections.unmodifiableList — nespremenljiv pogled na seznam

Prek pogleda seznama ni mogoče spreminjati, izvorni seznam pa ostane dostopen za spremembe. Če teh sprememb ne želite prikazati, ustvarite pogled na zasebno kopijo.

Različica: Java SE 21

Sintaksa

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 je statična metoda razreda java.util.Collections. Sprejme List<? extends T> in vrne List<T>. Če namesto seznama podate null, sproži NullPointerException. Rezultat je še vedno tipa List: klica, kot sta add in set, se prevedeta, vendar poskusi spreminjanja seznama prek pogleda, tudi prek njegovega iteratorja, med izvajanjem sprožijo UnsupportedOperationException.

Branje prek pogleda uporablja osnovni seznam. Če koda ohrani dostop do tega seznama in doda, odstrani ali zamenja element, poznejša branja prek pogleda pokažejo spremembo. Ta pristop uporabite, kadar mora klicatelj videti trenutno stanje seznama, ne sme pa ga spreminjati prek prejete reference.

Če želite ohraniti elemente in njihov vrstni red ob kopiranju, uporabite Collections.unmodifiableList(new ArrayList<>(source)). Kopije, ki jo je mogoče spreminjati, ne razkrijte in je pozneje ne spreminjajte. Rezultat je še vedno pogled, vendar na zasebno kopijo, ne na izvirnik. Kopija je plitva: deljeni spremenljivi elementi še vedno lahko spremenijo svoje stanje. Ovitek ne doda sinhronizacije.

Druga možnost je List.copyOf(source): vrne seznam, ki ga ni mogoče spreminjati, ne odraža poznejših sprememb izvornega seznama in ne vsebuje globokih kopij elementov. Elemente null zavrne z izjemo NullPointerException; pogled na zasebno kopijo, narejeno z new ArrayList<>(source), jih ohrani.

Primeri

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

Rezultat

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

`source.set` in `source.add` spremenita, kar bere `live`, ne pa tega, kar bere `snapshot`. Klic `live.set` se prevede, vendar sproži `UnsupportedOperationException`.

Povezane lekcije

  • Java · Lekcija 2 · Napredna · Različica: 2
  • Java · Lekcija 21 · Napredna · Različica: 2

Viri