collectors.summarizingint是java 8 stream api中用于int类型数据多维度统计的收集器,返回含计数、总和、最小值、最大值和平均值的intsummarystatistics对象。

Collectors.summarizingInt 是 Java 8 引入的 Stream API 中一个便捷的收集器,用于对 int 类型数据进行一次性多维度统计,返回 IntSummaryStatistics 对象,包含计数、总和、最小值、最大值和平均值。
基本用法:传入ToIntFunction提取整数值
该收集器接收一个 ToIntFunction,用于从流中每个元素提取要统计的 int 值。常见场景是统计对象字段或转换结果:
- 统计员工年龄总和、均值、极值等
- 对列表中字符串长度做摘要统计
- 将布尔值转为 0/1 后统计(如
b -> b ? 1 : 0)
示例:
ListIntSummaryStatistics stats = people.stream()
.collect(Collectors.summarizingInt(Person::getAge));
System.out.println(stats); // IntSummaryStatistics{count=3, sum=90, min=25, average=30.000000, max=35}
获取各项统计结果
返回的 IntSummaryStatistics 提供了直接获取各指标的方法,无需手动计算:
-
stats.getCount()—— 元素个数(非 null 元素数量) -
stats.getSum()—— 所有值之和(溢出时不抛异常,按 int 溢出规则处理) -
stats.getMin()—— 最小值(若流为空,返回Integer.MAX_VALUE) -
stats.getMax()—— 最大值(若流为空,返回Integer.MIN_VALUE) -
stats.getAverage()—— 平均值(double 类型;空流返回 0.0)
注意:空流不会抛异常,但极值初始值需留意,建议结合 stats.getCount() > 0 判断是否有效。
与其他统计收集器对比
Java 还提供了对应 long 和 double 的版本:
Collectors.summarizingLong(ToLongFunction)Collectors.summarizingDouble(ToDoubleFunction)
它们返回类型分别为 LongSummaryStatistics 和 DoubleSummaryStatistics,行为一致,仅数值类型和溢出/精度处理不同。选哪个取决于原始数据类型,避免隐式转换丢失精度或引发问题。
实际使用小提醒
- 确保映射函数不返回 null(否则会触发
NullPointerException) - 如果需要更复杂的聚合(如中位数、标准差),
summarizingInt不支持,需自定义收集器或用第三方库(如 Apache Commons Math) - 性能良好,内部单次遍历完成全部统计,比分别调用
counting()、summingInt()等更高效
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南











