Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Java

List.of e List.of() — liste non modificabili

`List.of` crea una lista non modificabile dagli elementi forniti. Senza argomenti, `List.of()` restituisce una lista vuota. Nessun overload accetta elementi `null`.

Versione: Java SE 21

Sintassi

import java.util.List;

List<E> empty = List.of();
List<E> values = List.of(e1, e2);

// Factory method signatures (E is the element type):
// static <E> List<E> of()
// static <E> List<E> of(E e1, ..., E eN)  [one overload for each N from 1 to 10]
// static <E> List<E> of(E... elements)

List.of è una famiglia di metodi factory statici dell’interfaccia java.util.List, disponibile da Java 9. List.of() è l’overload senza argomenti: restituisce una lista vuota e non modificabile, da passare quando è richiesta una lista ma non ci sono elementi da fornire. In List<String> empty = List.of();, Java deduce il tipo degli elementi dal tipo dichiarato della variabile.

Ci sono overload con un numero fisso di parametri per 1–10 elementi e un overload con argomenti variabili, of(E... elements), per qualsiasi numero di elementi. La lista conserva l’ordine degli argomenti e ammette duplicati. Se un elemento è null, la chiamata lancia NullPointerException invece di restituire una lista.

Chiamare add, remove o set sulla lista restituita provoca una UnsupportedOperationException, anche se la lista è vuota. Il fatto che la lista non sia modificabile non rende immutabili gli oggetti che contiene. Per aggiungere, rimuovere o sostituire elementi, crea una copia superficiale e modificabile con new ArrayList<>(source).

Esempi

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

public class ListOfDemo {
    public static void main(String[] args) {
        List<String> empty = List.of();
        List<String> colors = List.of("red", "blue", "red");
        System.out.println("Empty size: " + empty.size());
        System.out.println("Colors: " + String.join(", ", colors));

        try {
            colors.set(0, "green");
        } catch (UnsupportedOperationException expected) {
            System.out.println("UnsupportedOperationException");
        }

        try {
            List.of("red", null);
        } catch (NullPointerException expected) {
            System.out.println("NullPointerException");
        }

        List<String> editable = new ArrayList<>(empty);
        editable.add("green");
        System.out.println("Mutable copy: " + editable.get(0));
        System.out.println("Original size: " + empty.size());
    }
}

Risultato

Empty size: 0
Colors: red, blue, red
UnsupportedOperationException
NullPointerException
Mutable copy: green
Original size: 0

L’esempio mostra una lista vuota, il mantenimento dell’ordine e dei duplicati e due eccezioni diverse. Aggiungere un elemento alla copia modificabile non cambia la lista vuota di partenza.

Lezioni correlate

  • Java · Lezione 67 · Base · Versione: 2
  • Java · Lezione 34 · Intermedio · Versione: 2
  • Java · Lezione 43 · Intermedio · Versione: 2

Fonti