CKTIS / Java
List.copyOf : une copie superficielle non modifiable
`List.copyOf` renvoie un instantané non modifiable dans l’ordre d’itération de la collection source. Les objets des éléments sont partagés et `null` est refusé.
Version : Java SE 21
Syntaxe
static <E> List<E> copyOf(Collection<? extends E> coll)
List<E> snapshot = List.copyOf(coll);List.copyOf est une méthode statique de l’interface java.util.List, disponible depuis Java 10. Elle accepte une Collection<? extends E>, pas seulement une liste : les éléments peuvent être de type E ou d’un sous-type. La List<E> obtenue suit l’ordre d’itération de la collection source et conserve les doublons.
L’ajout, la suppression ou le remplacement d’un élément dans le résultat déclenche une UnsupportedOperationException. Les modifications ultérieures de la source, y compris le remplacement d’un élément, ne changent pas l’instantané. À l’inverse, Collections.unmodifiableList renvoie une vue non modifiable qui reflète les changements de la liste sous-jacente.
La copie est superficielle : l’instantané conserve des références aux mêmes objets. Une modification d’un StringBuilder partagé est donc visible dans l’instantané. Les objets String sont immuables, et leur partage ne présente pas ce risque. Pour que les éléments mutables aient un état indépendant, copiez-les eux aussi.
Si la collection elle-même ou l’un de ses éléments vaut null, l’appel déclenche une NullPointerException lors de la création de l’instantané. La méthode peut réutiliser une liste non modifiable appropriée : ne supposez pas que le résultat est toujours une nouvelle instance.
Exemples
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");
}
}
}Résultat
source: [green, blue] snapshot: [red, blue] UnsupportedOperationException shared element: AB NullPointerException
Remplacer `red` par `green` ne change que la source, et l’ajout à l’instantané échoue. Le `StringBuilder` partagé devient `AB`. Une fois `null` ajouté à la source, la tentative suivante de créer un instantané déclenche une `NullPointerException`.
Leçons associées
- Java · Leçon 1 · Avancé · Version : 2
- Java · Leçon 44 · Intermédiaire · Version : 2