Java中Collections.singletonList和singletonMap使用

Collections.singletonList创建不可变单元素列表，2. Collections.singletonMap创建不可变单键值对映射，二者均线程安全、高效节省内存，适用于只读场景如返回单元素集合或配置传递，不支持修改操作且允许null值，但需注意不可变性限制。

在Java中，Collections.singletonList 和 Collections.singletonMap 是两个非常实用的工具方法，用于创建不可变的单元素集合和单键值对映射。它们属于 java.util.Collections 类中的静态方法，适用于需要轻量级、只读集合的场景。

singletonList：创建不可变的单元素列表

当你只需要一个只包含一个元素的 List，并且不希望这个列表被修改时，可以使用 Collections.singletonList。

它返回一个线程安全、不可修改的 List 视图，访问效率高，不会额外创建复杂的结构。

示例：

立即学习“Java免费学习笔记（深入）”；

String name = "Alice";
List<String> names = Collections.singletonList(name);

注意：
- 返回的 List 不支持 add、remove、clear 等修改操作，调用这些方法会抛出 UnsupportedOperationException。
- 由于是视图形式，传入的对象仍可被外部修改（如果是可变对象），但集合结构本身不可变。
- 比 new ArrayList(Arrays.asList(obj)) 更高效，避免了额外的内存开销。

singletonMap：创建不可变的单键值对映射

当你只需要存放一个键值对的 Map 时，Collections.singletonMap 是理想选择。

百度文心百中

百度大模型语义搜索体验中心

22

查看详情

它返回一个不可变的 Map，其中仅包含指定的一个键和一个值。

示例：

立即学习“Java免费学习笔记（深入）”；

Integer userId = 1001;
String userName = "Bob";
Map<Integer, String> userMap = Collections.singletonMap(userId, userName);

特点：
- 同样不可修改，任何 put、remove 操作都会抛出异常。
- 线程安全，适合在多线程环境中作为常量数据传递。
- 内部实现简洁，节省内存，适用于配置、临时返回值等场景。

适用场景与注意事项

这两个方法特别适合以下情况：
- 方法需要返回一个 List 或 Map，但结果只有一个元素。
- 作为参数传递时，避免创建匿名集合对象。
- 在 Stream 中作为默认值或兜底值使用。

注意事项：
- 允许传入 null 值（包括 key 或 value 为 null），但需调用者自行保证逻辑正确。
- 返回的是不可变集合，不能重新赋值结构。
- 如果后续需要修改集合内容，应使用 ArrayList 或 HashMap 等可变类型。

基本上就这些。合理使用 singletonList 和 singletonMap 能让代码更简洁、安全，同时提升性能表现。

以上就是Java中Collections.singletonList和singletonMap使用的详细内容，更多请关注php中文网其它相关文章！