Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / Java

List.copyOf: plitka kopija liste bez mogućnosti izmjene

`List.copyOf` vraća snimku bez mogućnosti izmjene, u redoslijedu iteracije izvorne kolekcije. Objekti elemenata ostaju zajednički, a `null` se odbija.

Verzija: Java SE 21

Sintaksa

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

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

List.copyOf statička je metoda sučelja java.util.List, dostupna od Jave 10. Prima Collection<? extends E>, ne samo listu: elementi mogu biti tipa E ili njegova podtipa. Vraća List<E> u redoslijedu iteracije izvorne kolekcije i zadržava duplikate.

Dodavanje, uklanjanje ili zamjena elemenata u rezultatu izaziva UnsupportedOperationException. Naknadne promjene izvorne kolekcije, uključujući zamjenu elementa, ne utječu na snimku. Nasuprot tome, Collections.unmodifiableList vraća pogled koji nije moguće izravno mijenjati, ali u kojem su vidljive promjene osnovne liste.

Kopija je plitka: snimka sadrži reference na iste objekte. Promjena zajedničkog objekta StringBuilder zato je vidljiva i u snimci. Objekti String su nepromjenjivi pa njihovo dijeljenje ne nosi taj rizik. Ako ti treba neovisno stanje promjenjivih elemenata, kopiraj i same elemente.

Ako je kolekcija ili bilo koji njezin element null, pri izradi snimke poziv baca NullPointerException. Metoda može ponovno upotrijebiti prikladnu listu koja ne dopušta izmjene. Nemoj pretpostaviti da je rezultat uvijek nova instanca.

Primjeri

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

Zamjena `red` vrijednošću `green` mijenja samo izvornu kolekciju, a dodavanje u snimku ne uspijeva. Zajednički `StringBuilder` zatim sadrži `AB`. Nakon dodavanja `null` u izvornu kolekciju sljedeći pokušaj izrade snimke baca `NullPointerException`.

Povezane lekcije

  • Java · Lekcija 1 · Napredno · Verzija: 2
  • Java · Lekcija 44 · Srednje · Verzija: 2

Izvori