stream中peek方法的功能简介说明

Stream中Peek方法的功能

在Java中`Stream` API 中
 `peek`方法是对一个集合中间操作
    它允许在流的处理管道中对每个元素执行某种操作(如:打印或日志记录)
	  同时不会改变流中的数据。

Stream中Peek方法的特点

1.查看流中的元素：
   - `peek` 方法可以用来观察流中的每个元素
    而不会对流的内容产生任何修改。
   
2.调试工具：
   - 常用于调试流的操作链
    帮助开发者了解流在每个阶段的状态。

3.惰性求值：
   - 和其他中间操作一样，`peek` 是惰性求值的
     只有当终端操作(如 `collect`、`forEach` 等)被执行时
	  `peek` 才会被触发。

4.不改变流的行为：
   - `peek` 只是提供了一个“窥视”流中元素的机会
     并不会影响后续操作的结果

Stream中Peek方法签名

Stream<T> peek(Consumer<? super T> action)
- 参数：
    `action` 是一个 `Consumer` 函数式接口，
	  表示对每个元素执行的操作
- 返回值：
     返回一个新的流
	  包含与原流相同的数据

Stream中Peek方法使用场景

-调试流的中间状态：
  在复杂的流操作链中
    使用`peek`打印流中每个阶段的元素
	 帮助理解流的变换过程

list<Integer> numbers = Arrays.asList(1, 2, 3, 4, 5);

List<Integer> result = numbers.stream()
                              .filter(n -> n % 2 == 0) // 筛选出偶数
                              .peek(n -> System.out.println("Filtered value: " + n)) // 调试输出
                              .map(n -> n * 2) // 将偶数乘以 2
                              .peek(n -> System.out.println("Mapped value: " + n)) // 调试输出
                              .collect(Collectors.toList());

System.out.println("Result: " + result);
 
====运行以上代码，将输出以下信息=====

Filtered value: 2
Mapped value: 4
Filtered value: 4
Mapped value: 8
Result: [4, 8]

Stram之Peek使用注意事项

1.不要滥用 `peek`：
   - `peek` 的主要目的是调试，
      不适合用来实现业务逻辑。
   
2.无副作用：
   - 使用 `peek` 时应确保其操作不会对流外的状态产生副作用，
      否则可能导致不可预测的行为。

3.必须有终端操作：
   - 如果没有终端操作(如 `collect` 或 `forEach`)
     `peek`不会被执行
	  因为流是惰性求值