CKTIS / Java
List.of i List.of() — listy niemodyfikowalne
`List.of` tworzy niemodyfikowalną listę z podanych elementów, a `List.of()` zwraca pustą listę. Żadne przeciążenie nie dopuszcza elementów `null`.
Wersja: Java SE 21
Składnia
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 to rodzina statycznych metod fabrykujących interfejsu java.util.List, dostępna od Javy 9. List.of() to przeciążenie bez argumentów: zwraca pustą, niemodyfikowalną listę, którą można podać jako puste źródło tam, gdzie oczekiwana jest lista. W zapisie List<String> empty = List.of(); typ elementów wynika z typu zmiennej.
Istnieją przeciążenia o stałej liczbie parametrów dla 1–10 elementów oraz przeciążenie of(E... elements) przyjmujące dowolną liczbę elementów. Lista zachowuje kolejność argumentów i dopuszcza powtórzenia. Jeśli którykolwiek element to null, już podczas tworzenia listy wystąpi NullPointerException.
Wywołania add, remove i set na zwróconej liście zgłaszają UnsupportedOperationException, także gdy lista jest pusta. Niemodyfikowalność listy nie oznacza, że przechowywane w niej obiekty są niezmienne. Jeżeli chcesz zmieniać strukturę listy lub podmieniać elementy, utwórz płytką, modyfikowalną kopię: new ArrayList<>(source).
Przykłady
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());
}
}Wynik
Empty size: 0 Colors: red, blue, red UnsupportedOperationException NullPointerException Mutable copy: green Original size: 0
Przykład pokazuje pustą listę, zachowanie kolejności i powtórzeń oraz dwa różne wyjątki. Dodanie elementu do modyfikowalnej kopii nie zmienia pustego źródła.
Powiązane lekcje
- Java · Lekcja 67 · Podstawowy · Wersja: 2
- Java · Lekcja 34 · Średniozaawansowany · Wersja: 2
- Java · Lekcja 43 · Średniozaawansowany · Wersja: 2