Collectors.summarizingLong用于统计集合中long值的汇总信息，返回LongSummaryStatistics对象，可获取数量、总和、最值及平均值。
在Java中，Collectors.summarizingLong 是一个非常实用的收集器，用于对集合中的元素进行统计操作，特别适用于需要获取最大值、最小值、总和、平均值以及元素数量等汇总信息的场景。它常与 Stream API 配合使用，返回一个 LongSummaryStatistics 对象，包含所有统计结果。
1. 基本语法与返回类型
Collectors.summarizingLong 接收一个函数式接口 ToLongFunction<T>，该接口用于从集合元素中提取出 long 类型的值。其基本语法如下：
stream.collect(Collectors.summarizingLong(ToLongFunction<T> mapper))
返回的是一个 LongSummaryStatistics 实例，可通过以下方法获取统计信息：
立即学习“Java免费学习笔记（深入）”；
- getCount()：元素数量
- getSum()：总和
- getMin()：最小值（若无元素则返回 Long.MAX_VALUE）
- getMax()：最大值（若无元素则返回 Long.MIN_VALUE）
- getAverage()：平均值（空集合返回 0.0）
2. 统计 Long 类型集合的示例
假设有一个 List<Long>，我们想统计其中所有数值的汇总信息：
import java.util.*;
import java.util.stream.Collectors;
public class LongSummaryExample {
public static void main(String[] args) {
List<Long> numbers = Arrays.asList(10L, 20L, 30L, 40L, 50L);
LongSummaryStatistics stats = numbers.stream()
.collect(Collectors.summarizingLong(Long::longValue));
System.out.println("总数: " + stats.getCount());
System.out.println("总和: " + stats.getSum());
System.out.println("最小值: " + stats.getMin());
System.out.println("最大值: " + stats.getMax());
System.out.println("平均值: " + stats.getAverage());
}
}
输出结果为：
总数: 5
总和: 150
最小值: 10
最大值: 50
平均值: 30.0
3. 处理对象集合中的 Long 字段
更常见的用法是处理对象列表，例如统计用户年龄或订单金额等。假设有如下类：
class User {
private String name;
private long age;
public User(String name, long age) {
this.name = name;
this.age = age;
}
public long getAge() {
return age;
}
// getter 和 setter 省略
}
统计用户年龄的汇总信息：
List<User> users = Arrays.asList(
new User("Alice", 25L),
new User("Bob", 30L),
new User("Charlie", 35L)
);
LongSummaryStatistics ageStats = users.stream()
.collect(Collectors.summarizingLong(User::getAge));
System.out.println("用户数: " + ageStats.getCount());
System.out.println("总年龄: " + ageStats.getSum());
System.out.println("最年轻: " + ageStats.getMin());
System.out.println("最年长: " + ageStats.getMax());
System.out.println("平均年龄: " + ageStats.getAverage());
4. 注意事项与适用场景
使用 summarizingLong 时需注意以下几点：
- 传入的函数必须返回 long 类型，不能是 null，否则会抛出 NullPointerException
- 空集合不会抛异常，但 min/max 会有默认值，平均值为 0.0
- 适合需要多项统计的场景，避免多次遍历集合计算 sum、max 等
- 性能优于分别调用 mapToInt().sum()、max() 等多次终端操作
基本上就这些。这个收集器简洁高效，特别适合在数据聚合、报表生成等业务中使用。只要确保提取字段非 null，就能安全使用。
