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

CKTIS / Java

List.copyOf: plitva kopija seznama brez možnosti spreminjanja

`List.copyOf` vrne posnetek v vrstnem redu iteracije po izvorni zbirki. Seznama ni mogoče spreminjati, objekti elementov so skupni, `null` pa ni dovoljen.

Različica: Java SE 21

Sintaksa

static <E> List<E> copyOf(Collection<? extends E> coll)

List<E> snapshot = List.copyOf(coll);

List.copyOf je statična metoda vmesnika java.util.List, ki je na voljo od Jave 10. Sprejme Collection<? extends E>, ne le seznama: elementi so lahko tipa E ali njegovega podtipa. Vrne List<E> v vrstnem redu iteracije po izvorni zbirki in ohrani podvojene elemente.

Dodajanje, odstranjevanje ali zamenjava elementov v rezultatu sproži UnsupportedOperationException. Poznejše spremembe v izvorni zbirki, vključno z zamenjavo elementa, ne vplivajo na posnetek. Nasprotno Collections.unmodifiableList vrne pogled, ki ga ni mogoče spreminjati neposredno, vendar odraža spremembe osnovnega seznama.

Kopija je plitva: posnetek hrani reference na iste objekte. Sprememba skupnega objekta StringBuilder je zato vidna tudi v posnetku. Objekti String so nespremenljivi, zato pri njih tega tveganja ni. Če potrebuješ neodvisno stanje spremenljivih elementov, kopiraj tudi same elemente.

Če je zbirka ali kateri od njenih elementov null, klic pri ustvarjanju posnetka sproži NullPointerException. Metoda lahko znova uporabi primeren seznam, ki ga ni mogoče spreminjati. Ne predpostavljaj torej, da je rezultat vedno nov primerek.

Primeri

import java.util.ArrayList;
import java.util.List;

public class Main {
    public static void main(String[] args) {
        List<String> source = new ArrayList<>(List.of("red", "blue"));
        List<String> snapshot = List.copyOf(source);
        source.set(0, "green");
        System.out.println("source: " + source);
        System.out.println("snapshot: " + snapshot);

        try {
            snapshot.add("yellow");
        } catch (UnsupportedOperationException e) {
            System.out.println("UnsupportedOperationException");
        }

        StringBuilder shared = new StringBuilder("A");
        List<StringBuilder> mutableSnapshot = List.copyOf(List.of(shared));
        shared.append("B");
        System.out.println("shared element: " + mutableSnapshot.get(0));

        source.add(null);
        try {
            List.copyOf(source);
        } catch (NullPointerException e) {
            System.out.println("NullPointerException");
        }
    }
}

Rezultat

source: [green, blue]
snapshot: [red, blue]
UnsupportedOperationException
shared element: AB
NullPointerException

Zamenjava `red` z `green` spremeni le izvorno zbirko, dodajanje v posnetek pa ne uspe. Skupni `StringBuilder` nato vsebuje `AB`. Ko izvorni zbirki dodaš `null`, naslednji poskus ustvarjanja posnetka sproži `NullPointerException`.

Povezane lekcije

  • Java · Lekcija 1 · Napredna · Različica: 2
  • Java · Lekcija 44 · Srednja · Različica: 2

Viri