极客笔记Java中的Collections singletonList()方法及示例
在Java中，有时候我们需要定义一个只包含一个元素的集合，而对于这样的需求，Java中的Collections类中提供了一个非常实用的方法：singletonList()
singletonList()方法概述
singletonList()方法是Collections类中的一个静态方法，用于返回一个只包含指定对象的不可修改列表。
其方法签名如下：
public static <T> List<T> singletonList(T obj)
其中，T为指定对象的类型，obj为指定的元素。
该方法返回一个包含单个元素的List，该列表不可修改（不允许添加、删除元素）且不允许为null。
singletonList()示例
下面是一个简单的示例，展示了如何使用singletonList()方法创建一个只包含一个元素的List：
import java.util.Collections;
import java.util.List;
public class SingletonListExample {
public static void main(String[] args) {
String str = "Hello World!";
List<String> list = Collections.singletonList(str);
System.out.println("list: " + list);
// trying to add an element
try {
list.add("Goodbye!");
} catch (UnsupportedOperationException e) {
System.out.println("Error: " + e.getMessage());
}
}
}
该示例创建了一个只包含一个字符串元素的List，并使用System.out.println()方法打印了该List的内容。
输出：
list: [Hello World!]
Error: null
从输出中可以发现，该List包含一个字符串元素，并且操作添加元素时抛出了UnsupportedOperationException异常，提示该List不允许修改。
singletonList()方法的注意事项
在使用singletonList()方法时需要注意以下两点:
- singletonList()返回的List是不可修改的，因此在添加、删除或修改元素时都会抛出UnsupportedOperationException异常。
- singletonList()返回的List不允许为null，因为该List只包含一个元素。
结论
综上所述, singletonList()方法是Java Collections类中提供的一个非常实用的方法，用于创建只包含一个元素的不可修改List。在使用时需要注意到返回的List不允许添加、删除或修改元素，且该List不允许为null。