Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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

Źródła