283. Java Stream API - 创建一个空的 Stream

283. Java Stream API - 创建一个空的 Stream

✅ 什么是空流？

空流（empty stream）就是不包含任何元素的Stream。创建方式非常简单，使用Stream.empty()工厂方法即可。

🧪 示例：创建一个空流

Stream<String>empty=Stream.empty();List<String>strings=empty.toList();System.out.println("strings = "+strings);

输出结果：

strings=[]

就这么简单，一行代码就能创建出一个什么都不包含的流！

💡 空流的使用场景

你可能会问：这有啥用？其实，空流在写可组合代码时非常有用！

以下是几个典型的使用场景：

🎯 场景 1：避免空指针异常（NullPointerException）

List<String>list=null;// 错误写法：会抛出 NPE// list.stream().forEach(System.out::println);// 安全写法：使用 Optional + 空流兜底Stream<String>safeStream=Optional.ofNullable(list).map(List::stream).orElse(Stream.empty());safeStream.forEach(System.out::println);// 什么也不打印，但程序不会挂

🎯 场景 2：流式拼接时动态返回空流

比如你从某个数据源中获取一批数据，有时候会返回空结果，但你仍然想继续拼接或操作后续流：

Stream<String>dbResults=fetchFromDB();// 假设这里可能返回空Stream<String>merged=Stream.concat(dbResults,Stream.of("default"));merged.forEach(System.out::println);

如果fetchFromDB()返回Stream.empty()，也不会出错，你依然能打印出默认值。

🎯 场景 3：在flatMap()中用于“条件跳过”

假设我们在做嵌套数据处理，不满足条件的直接返回空流跳过：

Stream<String>words=Stream.of("apple","banana","pear");Stream<Character>letters=words.flatMap(word->{if(word.length()<5)returnStream.empty();returnword.chars().mapToObj(c->(char)c);});letters.forEach(System.out::println);

输出：

a p p l e b a n a n a

小于5个字符的单词"pear"被跳过了（因为返回的是Stream.empty()）。

🚀 Java 16：推荐替代方案 —mapMulti()

从Java 16开始，推荐使用mapMulti()来代替flatMap+empty组合，它效率更高、语义更清晰。

示例对比：

List<String>words=List.of("apple","banana","pear");Stream<Character>chars=words.stream().<Character>mapMulti((word,consumer)->{if(word.length()>=5){for(charc:word.toCharArray()){consumer.accept(c);}}});chars.forEach(System.out::println);

作用同上，但避免了返回中间流对象，更加轻量！

🧠 小结