棱镜BLOG

List集合的流式方法

VitaminE · · #Java

List集合的流式方法中map以及peek的对比

peek:消费型操作,看一眼数据但不改变流内容,常用于调试。 map:转换型操作,将每个元素映射为新值,生成新流。

特性mappeek
设计目的转换元素,将流中的元素映射为新的元素查看/调试元素,观察流中元素的流动状态
接收参数Function(有入参,有返回值)Consumer(有入参,无返回值/void)
流的结果返回一个新的流,流中的元素被替换为转换后的结果返回原流的副本,流中的元素保持不变

💡 核心区别详解

  1. map:用于“转换”

map 的核心作用是把一个东西变成另一个东西。它接收一个 Function 函数式接口,该接口会对流中的每个元素进行计算,并返回一个新的值。这个新值会替换掉原来的元素,进入下一个流操作。
典型场景:将字符串转为大写、从对象中提取某个属性(如从 User 对象中提取 name)、数据类型转换等。

List<String> list = Arrays.asList("a", "b", "c");
// 将每个元素转换为大写,collect 收集到的结果是 [A, B, C]
List<String> result = list.stream()
    .map(String::toUpperCase) 
    .collect(Collectors.toList());
  1. peek:用于“查看”或“调试”

peek 的核心作用是“路过看一眼”。它接收一个 Consumer 函数式接口,该接口只会消费元素(比如打印日志、断点调试),但不会返回任何新值。因此,流中的元素在经过 peek 后,依然是它自己。
典型场景:在复杂的流处理管道中,打印中间结果以确认 filter 或 map 是否按预期工作。

List<String> list = Arrays.asList("a", "b", "c");
// 只是打印元素,不改变元素本身,collect 收集到的结果依然是 [a, b, c]
List<String> result = list.stream()
    .peek(System.out::println) 
    .collect(Collectors.toList());

⚠️ 特别注意:peek 修改对象的“陷阱”

网上看到一些说法,认为 peek 也可以修改元素的值。这其实是一个容易让人混淆的特例,涉及到 Java 的引用传递。
对于不可变对象(如 String):peek 无法改变它的值。因为 String::toUpperCase 会返回一个新的字符串,而 peek 会把该返回值丢弃,所以原流中的字符串不会变。
对于可变对象(如自定义的 User 实体类):如果你在 peek 中调用了对象的 setter 方法(例如 user -> user.setAge(18)),原对象的属性确实会被修改。但这并不是 peek 改变了流中的元素指向,而是因为你通过引用直接修改了堆内存中对象的状态。
最佳实践建议:
需要转换数据,一定使用 map。
为了打印日志、排查 Bug,可以使用 peek。
尽量避免在 peek 中修改对象的内部状态(调用 setter),这违背了它的设计初衷,且在并行流(parallelStream)中可能会引发线程安全问题。