在Java 8及更高版本的Stream API中,Collectors.summarizingLong是一个专门用于统计Long类型流元素的方法,它可以一次性计算出集合中所有Long元素的总和、平均值、最大值、最小值以及元素总个数,避免了多次遍历集合的繁琐操作。

Collectors.summarizingLong的基本用法
该方法接收一个ToLongFunction函数式接口作为参数,用于从流元素中提取需要统计的Long类型值,最终返回一个LongSummaryStatistics对象,该对象包含了所有统计结果。
基础统计示例
假设我们有一个包含多个用户对象的集合,每个用户有对应的积分字段,需要统计所有用户的积分总和、平均积分、最高积分、最低积分以及用户总人数,代码如下:
import java.util.ArrayList;
import java.util.List;
import java.util.LongSummaryStatistics;
import java.util.stream.Collectors;
class User {
private String name;
private Long score;
public User(String name, Long score) {
this.name = name;
this.score = score;
}
// 获取积分的方法,用于summarizingLong提取数据
public Long getScore() {
return score;
}
}
public class SummarizingLongDemo {
public static void main(String[] args) {
// 初始化用户集合
List<User> userList = new ArrayList<>();
userList.add(new User("张三", 85L));
userList.add(new User("李四", 92L));
userList.add(new User("王五", 78L));
userList.add(new User("赵六", 95L));
userList.add(new User("孙七", 88L));
// 使用Collectors.summarizingLong统计积分
LongSummaryStatistics stats = userList.stream()
.collect(Collectors.summarizingLong(User::getScore));
// 输出统计结果
System.out.println("总积分:" + stats.getSum());
System.out.println("平均积分:" + stats.getAverage());
System.out.println("最高积分:" + stats.getMax());
System.out.println("最低积分:" + stats.getMin());
System.out.println("用户总人数:" + stats.getCount());
}
}
上述代码运行后,会输出以下结果:
- 总积分:438
- 平均积分:87.6
- 最高积分:95
- 最低积分:78
- 用户总人数:5
LongSummaryStatistics核心方法说明
LongSummaryStatistics是summarizingLong的返回对象,提供了多个获取统计结果的方法,具体如下表:
| 方法名 | 返回值类型 | 说明 |
|---|---|---|
| getCount() | long | 返回统计的元素总个数 |
| getSum() | long | 返回所有元素的总和 |
| getAverage() | double | 返回所有元素的平均值,如果没有元素则返回0.0 |
| getMax() | long | 返回所有元素的最大值,如果没有元素则返回Long.MIN_VALUE |
| getMin() | long | 返回所有元素的最小值,如果没有元素则返回Long.MAX_VALUE |
直接统计Long类型集合的场景
如果集合本身就是Long类型的,不需要从对象中提取字段,可以直接使用e -> e作为summarizingLong的参数,示例如下:
import java.util.Arrays;
import java.util.List;
import java.util.LongSummaryStatistics;
import java.util.stream.Collectors;
public class DirectLongListDemo {
public static void main(String[] args) {
List<Long> numList = Arrays.asList(10L, 20L, 30L, 40L, 50L);
LongSummaryStatistics stats = numList.stream()
.collect(Collectors.summarizingLong(e -> e));
System.out.println("总和:" + stats.getSum());
System.out.println("平均值:" + stats.getAverage());
System.out.println("最大值:" + stats.getMax());
System.out.println("最小值:" + stats.getMin());
System.out.println("元素个数:" + stats.getCount());
}
}
使用注意事项
- summarizingLong的参数必须是返回long或Long类型的函数,否则会编译报错。
- 如果流中没有元素,调用getMax()会返回Long.MIN_VALUE,getMin()返回Long.MAX_VALUE,使用时需要注意边界情况。
- 该方法只会遍历一次集合,相比分别调用sum、max、min等方法,性能更优,适合需要同时获取多个统计指标的场景。
Collectors.summarizingLong是Java Stream API中非常实用的统计工具,能够大幅简化Long类型集合的统计代码,建议在有相关统计需求时优先使用。
Collectors.summarizingLongLong_summaryStatisticsJava_stream集合汇总统计修改时间:2026-07-16 17:48:23