1. 背景与问题：Stream中的类型过滤与转换
在处理java集合时，我们经常会遇到一个超类型（如animal）的流，但我们只对其中的特定子类型（如zebra）感兴趣。传统的做法通常是先使用filter筛选出特定类型的实例，然后通过map进行强制类型转换：
Stream<Animal> animalStream = Stream.of(new Zebra(), new Lion(), new Zebra());
Stream<Zebra> zebraStream = animalStream
.filter(Zebra.class::isInstance)
.map(Zebra.class::cast); // 需要显式类型转换Java 14引入的instanceof模式匹配极大地简化了条件判断和类型转换的结合：
if (animal instanceof Zebra zebra) {
// 在此作用域内，animal 已经被安全地转换为 Zebra 类型的 zebra
System.out.println(zebra.countStripes());
}然而，如何将这种简洁的模式匹配应用到Stream管道中，避免诸如先map为可能为null的子类型再filter(Objects::nonNull)的“丑陋”写法，成为了一个值得探讨的问题。
// 这种方式虽然可行，但不推荐，因为它引入了中间的null值处理
Stream<Zebra> zebraStream = animalStream.map(animal -> {
if (animal instanceof Zebra zebra) {
return zebra;
}
return null;
})
.filter(Objects::nonNull);接下来，我们将介绍两种更优雅、高效的解决方案。
2. 利用 mapMulti() 进行类型转换与过滤
Java 16引入的Stream.mapMulti()方法提供了一种高效的方式来执行“一对零或多”的转换。它接收一个BiConsumer，其中第一个参数是原始流的元素，第二个参数是一个Consumer，用于接受零个或多个转换后的元素。这使得它非常适合在Stream中结合instanceof模式匹配进行类型过滤和转换。
立即学习“Java免费学习笔记（深入）”；
工作原理：mapMulti()允许我们检查每个流元素。如果元素符合特定的子类型（通过instanceof模式匹配），我们就通过提供的Consumer将其“发射”到下游流中。如果不符合，则不发射任何元素，从而实现了过滤效果。
示例代码：
import java.util.stream.Stream;
// 假设有 Animal 及其子类 Zebra
class Animal {}
class Zebra extends Animal {
public void countStripes() {
System.out.println("Counting stripes on a Zebra.");
}
}
class Lion extends Animal {}
public class StreamPatternMatchingWithMapMulti {
public static void main(String[] args) {
Stream<Animal> animalStream = Stream.of(new Zebra(), new Lion(), new Zebra(), new Animal());
System.out.println("Using mapMulti():");
Stream<Zebra> zebraStream = animalStream
.mapMulti((animal, consumer) -> {
if (animal instanceof Zebra zebra) { // 模式匹配
consumer.accept(zebra); // 如果是Zebra，则将其发送到下游
}
});
zebraStream.forEach(Zebra::countStripes);
// 输出：
// Counting stripes on a Zebra.
// Counting stripes on a Zebra.
}
}注意事项：
- mapMulti()在Java 16及更高版本中可用。
- 它避免了创建中间的null值或额外的Stream对象，在处理大量数据时可能更高效。
3. 利用 flatMap() 进行类型转换与过滤
经典的Stream.flatMap()操作通常用于将一个流中的每个元素转换为一个新流，然后将所有这些新流扁平化为一个单一的流。虽然它的主要目的是“一对多”转换，但我们也可以巧妙地利用它来实现“一对零或一”的类型过滤和转换。
工作原理： 对于每个流元素，我们使用instanceof模式匹配进行检查。如果元素是目标子类型，我们就创建一个只包含该子类型实例的单元素流（Stream.of(zebra)）。如果不是，我们返回null。flatMap()在遇到null时，会将其视为一个空流，从而有效地过滤掉了不符合条件的元素。
示例代码：
import java.util.stream.Stream;
// 假设有 Animal 及其子类 Zebra
// (与上文相同的类定义)
public class StreamPatternMatchingWithFlatMap {
public static void main(String[] args) {
Stream<Animal> animalStream = Stream.of(new Zebra(), new Lion(), new Zebra(), new Animal());
System.out.println("Using flatMap():");
Stream<Zebra> zebraStream = animalStream
.flatMap(animal ->
animal instanceof Zebra zebra ? Stream.of(zebra) : null // 模式匹配并返回单元素流或null
);
zebraStream.forEach(Zebra::countStripes);
// 输出：
// Counting stripes on a Zebra.
// Counting stripes on a Zebra.
}
}null处理的优势： 根据flatMap的文档说明，如果映射函数返回null，flatMap会将其视为一个空流来处理。这意味着我们无需显式返回Stream.empty()，这在某些情况下可以避免创建不必要的空Stream对象，从而提高效率。
4. mapMulti() 与 flatMap() 的选择与考量
两种方法都能优雅地实现Stream中instanceof模式匹配的类型过滤和转换，但在选择时可以考虑以下几点：
- 性能： 对于非常大的流，mapMulti()通常被认为是更高效的选择，因为它避免了为每个匹配元素创建新的单元素Stream对象。flatMap()在内部需要处理这些中间流的创建和扁平化。
-
语义清晰度：
- mapMulti()更直接地表达了“根据条件发射零个或一个元素”的意图，尤其是在需要一对多转换时其优势更为明显。
- flatMap()虽然也能实现，但其核心语义是扁平化多个流，用它来做一对零或一的转换可能略显“借用”。
- Java版本： mapMulti()要求Java 16及以上版本，而flatMap()是Stream API的早期特性，在更老的Java版本中也可用（但模式匹配本身需要Java 14+）。
5. 总结
结合Java 14+的instanceof模式匹配，Stream.mapMulti()（Java 16+）和Stream.flatMap()为在Stream管道中高效、类型安全地进行类型过滤和转换提供了优雅的解决方案。它们避免了传统方法中显式类型转换和冗余的空值过滤，使得代码更加简洁、易读。在实际应用中，根据项目所使用的Java版本和对性能的极致要求，可以选择最适合的方法。对于大多数现代Java项目，mapMulti()因其更高的效率和清晰的语义，通常是更推荐的选择。
