Java `Collections.singletonList` 使用详解

public static <T> List<T> singletonList(T o)

该方法接收一个参数 o，表示要生成单个元素列表的元素，返回值类型是 List<T>，即一个只包含一个元素的列表。

使用方法

导入包

在使用 Collections.singletonList 方法之前，首先需要导入 java.util.Collections 包，可以使用以下语句导入：

import java.util.Collections;

创建单个元素列表

要创建一个只包含一个元素的列表，可以使用以下代码：

List<String> list = Collections.singletonList("apple");

上述代码创建了一个只包含一个元素 "apple" 的列表，该列表不可修改。

访问列表元素

与普通的列表一样，可以使用索引来访问 singletonList 创建的列表的元素。例如，要访问列表中的第一个元素，可以使用以下代码：

String firstElement = list.get(0);
System.out.println(firstElement);

运行上述代码，将输出：

apple

修改列表

由于 singletonList 创建的列表是不可修改的，因此不能对其进行任何修改操作（比如添加、删除和更新元素）。如果尝试对其进行修改，将会抛出 UnsupportedOperationException 异常。

list.add("banana"); // 抛出 UnsupportedOperationException
list.remove(0); // 抛出 UnsupportedOperationException
list.set(0, "orange"); // 抛出 UnsupportedOperationException

适用场景

Collections.singletonList 方法适用于以下场景：

当我们只需要包含单个元素的列表时，可以使用该方法来创建一个不可修改的列表。
当我们需要向方法或函数传递一个单个元素的列表时，可以使用该方法来快速创建一个不可修改的列表作为参数。

注意事项

在使用 Collections.singletonList 方法时，需要注意以下几点：

创建的列表是不可修改的。如果需要对列表进行修改操作，可以考虑使用其他列表实现，比如 ArrayList 或 LinkedList。
singletonList 方法返回的列表不支持修改操作，因此调用任何修改操作的方法都会抛出 UnsupportedOperationException 异常。
如果要创建一个空列表，不应该使用 singletonList 方法，而应该使用 Collections.emptyList() 方法。

示例代码

以下是使用 Collections.singletonList 方法的示例代码：

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

public class SingletonListExample {
    public static void main(String[] args) {
        // 创建只包含一个元素的列表
        List<String> list = Collections.singletonList("apple");

        // 访问列表元素
        String firstElement = list.get(0);
        System.out.println(firstElement);

        // 尝试修改列表
        try {
            list.add("banana");
        } catch (UnsupportedOperationException e) {
            System.out.println("UnsupportedOperationException: " + e.getMessage());
        }

        // 创建空列表
        List<String> emptyList = Collections.emptyList();
        System.out.println(emptyList.isEmpty());
    }
}

运行上述代码，将输出：

apple
UnsupportedOperationException: null
true

上述代码首先创建了一个只包含一个元素 "apple" 的列表，并输出了列表中的元素。

然后，我们尝试向列表添加元素，但由于列表是不可修改的，因此抛出了 UnsupportedOperationException 异常，并进行了异常处理。

最后，我们使用 Collections.emptyList() 方法创建了一个空列表，并检查了列表是否为空。

总结

本文详细介绍了 Java 中的 Collections.singletonList 方法的使用方法、适用场景、注意事项以及示例代码。singletonList 方法提供了一种快速创建只包含一个元素的不可修改列表的方法。但需要注意的是，该方法创建的列表是不可修改的，不能进行添加、删除或更新元素的操作。如果需要对列表进行修改操作，应该选择其他列表实现。