База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / Java

List.of и List.of() — списъци без възможност за промяна

`List.of` създава списък, който не може да се променя, от подадените елементи. `List.of()` без аргументи връща празен списък. Никоя версия на метода не приема елементи `null`.

Версия: Java SE 21

Синтаксис

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 е семейство от статични фабрични методи на интерфейса java.util.List, достъпни от Java 9. List.of() е вариантът без аргументи: той връща празен списък, който не може да се променя. Можеш да го подадеш, когато се очаква списък, но няма елементи. В List<String> empty = List.of(); Java извежда типа на елементите от декларирания тип на променливата.

Има претоварени варианти с фиксиран брой параметри за 1–10 елемента и вариант с променлив брой аргументи of(E... elements) за произволен брой елементи. Списъкът запазва реда на аргументите и допуска повторения. Ако някой подаден елемент е null, извикването хвърля NullPointerException, вместо да върне списък.

Извикването на add, remove или set върху върнатия списък хвърля UnsupportedOperationException дори ако списъкът е празен. Това, че списъкът не може да се променя, не означава, че обектите в него са неизменяеми. Ако трябва да добавяш, премахваш или заменяш елементи, създай плитко копие, което може да се променя, с new ArrayList<>(source).

Примери

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());
    }
}

Резултат

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

Примерът показва празен списък, запазване на реда и повторенията и две различни изключения. Добавянето на елемент в копието не променя първоначалния празен списък.

Свързани уроци

  • Java · Урок 67 · Начално · Версия: 2
  • Java · Урок 34 · Средно · Версия: 2
  • Java · Урок 43 · Средно · Версия: 2

Източници