Java 16 的 Stream.toList() 和 Stream.collect(Collectors.toList()) 的区别？

编程问答 2022-05-28

问题描述

JDK 16 now includes a toList() method directly on Stream instances。在以前的 Java 版本中，您总是必须使用 collect 方法并提供一个 Collector 实例。

新方法显然需要输入更少的字符。这两种方法是否可以互换，或者是否存在应该注意的细微差别？

var newList = someCollection.stream()
    .map(x -> mapX(x))
    .filter(x -> filterX(x))
    .toList();

// vs.

var oldList = someCollection.stream()
    .map(x -> mapX(x))
    .filter(x -> filterX(x))
    .collect(Collectors.toList());

（此问题类似于 Would Stream.toList() perform better than Collectors.toList()，但关注行为而非（仅）表现。）

解决方法

一个区别是 Stream.toList() 提供了一个不可变的 List 实现（类型 ImmutableCollections.ListN 不能被添加或排序）类似于 List.of() 和与 ArrayList 提供的可变（可以更改和排序）Stream.collect(Collectors.toList()) 形成对比。

演示：

import java.util.stream.Stream;
import java.util.List;

public class Main {
    public static void main(String[] args) {
        List<String> list = Stream.of("Hello").toList();
        System.out.println(list);
        list.add("Hi");
    }
}

输出：

[Hello]
Exception in thread "main" java.lang.UnsupportedOperationException
    at java.base/java.util.ImmutableCollections.uoe(ImmutableCollections.java:142)
    at java.base/java.util.ImmutableCollections$AbstractImmutableCollection.add(ImmutableCollections.java:147)
    at Main.main(Main.java:8)

请查看this article了解更多详情。

更新：

有趣的是，Stream.toList() 成功返回了一个包含 null 的列表。

import java.util.stream.Stream;
import java.util.List;

public class Main {
    public static void main(String[] args) {
        List<Object> list = Stream.of(null,null).toList();
        System.out.println(list);
    }
}

输出：

[null,null]

另一方面，List.of(null,null) 抛出 NullPointerException。

import java.util.List;

public class Main {
    public static void main(String[] args) {
        List<Object> list = List.of(null,null);
    }
}

输出：

Exception in thread "main" java.lang.NullPointerException
    at java.base/java.util.Objects.requireNonNull(Objects.java:208)
    at java.base/java.util.ImmutableCollections$List12.<init>(ImmutableCollections.java:453)
    at java.base/java.util.List.of(List.java:827)
    at Main.main(Main.java:5)

注意：我使用了openjdk-16-ea+34_osx-x64来编译和执行 Java SE 16 代码。

有用资源：

  1. JDK 错误#JDK-8180352
  2. Calling Java varargs method with single null argument?
,

这是一个小表格，总结了 Stream.collect(Collectors.toList())、Stream.collect(Collectors.toUnmodifiableList()) 和 Stream.toList() 之间的区别：

  • collect(toList())：保证不可修改 - 否；允许空值 - 是
  • collect(toUnmodifiableList())：保证不可修改 - 是；允许空值 - 否
  • toList()：保证不可修改 - 是；允许空值 - 是
collectorsjavajavajava-16java-stream