CKTIS / Java
List.copyOf: een onwijzigbare, oppervlakkige lijstkopie
`List.copyOf` geeft een onwijzigbare momentopname in de iteratievolgorde van de broncollectie. De elementobjecten worden gedeeld en `null` wordt geweigerd.
Versie: Java SE 21
Syntax
static <E> List<E> copyOf(Collection<? extends E> coll)
List<E> snapshot = List.copyOf(coll);List.copyOf is een statische methode van de interface java.util.List, beschikbaar sinds Java 10. De methode accepteert een Collection<? extends E>, niet alleen een lijst: elementen mogen van type E of een subtype zijn. De resulterende List<E> volgt de iteratievolgorde van de broncollectie en behoudt duplicaten.
Elementen toevoegen, verwijderen of vervangen in het resultaat geeft een UnsupportedOperationException. Latere wijzigingen in de bron, waaronder het vervangen van een element, veranderen de momentopname niet. Collections.unmodifiableList geeft daarentegen een onwijzigbare weergave waarin wijzigingen aan de onderliggende lijst wel zichtbaar zijn.
De kopie is oppervlakkig: de momentopname verwijst naar dezelfde elementobjecten. Een wijziging aan een gedeelde StringBuilder is dus ook zichtbaar in de momentopname. String-objecten zijn onveranderlijk, dus delen brengt dat risico niet mee. Wil je dat veranderlijke elementen een onafhankelijke toestand hebben, kopieer dan ook de elementen zelf.
Als de collectie zelf of een van haar elementen null is, geeft de aanroep bij het maken van de momentopname een NullPointerException. De methode kan een geschikte onwijzigbare lijst hergebruiken. Ga er dus niet van uit dat het resultaat altijd een nieuwe instantie is.
Voorbeelden
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");
}
}
}Resultaat
source: [green, blue] snapshot: [red, blue] UnsupportedOperationException shared element: AB NullPointerException
Als je `red` door `green` vervangt, verandert alleen de bron. Toevoegen aan de momentopname mislukt. De gedeelde `StringBuilder` bevat daarna `AB`. Zodra `null` aan de bron is toegevoegd, geeft de volgende poging om een momentopname te maken een `NullPointerException`.
Gerelateerde lessen
- Java · Les 1 · Gevorderd · Versie: 2
- Java · Les 44 · Gemiddeld · Versie: 2