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) return Stream.empty();
    return word.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 (char c : word.toCharArray()) {
            consumer.accept(c);
        }
    }
});

chars.forEach(System.out::println);

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

🧠 小结