Метод emptyList

Метод emptyList класса Collections возвращает неизменяемый (иммутабельный) пустой список. Метод не принимает никаких параметров и всегда возвращает один и тот же экземпляр пустого списка. Такой список нельзя изменить: при попытке добавить, удалить или заменить элемент будет выброшено исключение UnsupportedOperationException. Метод удобно использовать, когда нужно вернуть пустой список вместо null или создать заведомо пустую коллекцию.

Синтаксис

Collections.emptyList()

Пример

Давайте получим пустой список и выведем его на экран:

import java.util.Collections;
import java.util.List;

public class Main
{
	public static void main(String[] args)
	{
		List<String> res = Collections.emptyList();
		System.out.println(res);
		System.out.println(res.size());
	}
}

Результат выполнения кода:

[]
0

Пример

Давайте убедимся, что полученный список нельзя изменить:

import java.util.Collections;
import java.util.List;

public class Main
{
	public static void main(String[] args)
	{
		List<String> res = Collections.emptyList();
		
		try
		{
			res.add("a");
		}
		catch (UnsupportedOperationException e)
		{
			System.out.println("Список нельзя изменить");
		}
	}
}

Результат выполнения кода:

"Список нельзя изменить"

Пример

Давайте проверим, что метод всегда возвращает один и тот же экземпляр списка:

import java.util.Collections;
import java.util.List;

public class Main
{
	public static void main(String[] args)
	{
		List<String> res1 = Collections.emptyList();
		List<String> res2 = Collections.emptyList();
		
		System.out.println(res1 == res2);
	}
}

Результат выполнения кода:

true

Смотрите также

класс Collections,
который содержит статические методы для работы с коллекциями
метод singletonList,
который возвращает неизменяемый список из одного элемента
метод unmodifiableList,
который возвращает неизменяемую обертку над списком
метод nCopies,
который возвращает список из n копий элемента