如何在 Java 中利用 Collectors.summarizingInt() 一次性获取集合的计数、总和、均值和极值

夜伟吖_6917

夜伟吖_6917

2026-05-06

143人浏览

原创

Collectors.summarizingInt()可一次性获取计数、总和、均值、最小值、最大值,无需多次遍历或手动封装;它接收对象流及ToIntFunction提取int字段,要求方法返回int或可拆箱Integer,空值未处理会抛NPE,结果通过getter获取,getSum()返回long防溢出,空集合时getMin()/getMax()返回哨兵值,getAverage()返回0.0而非NaN。

如何在 java 中利用 collectors.summarizingint() 一次性获取集合的计数、总和、均值和极值

Collectors.summarizingInt() 是 Java 8 Stream API 中最被低估的聚合工具之一——它真能一次性拿到计数、总和、均值、最小值、最大值,且不遍历多次、不手动封装对象。

用法很简单:传入一个 ToIntFunction 提取整型字段

它不是直接接收 int 流,而是接收任意对象流,并靠你提供的函数“抠出”一个 int 值来统计。比如对 List 按年龄汇总:

IntSummaryStatistics stats = people.stream()
    .collect(Collectors.summarizingInt(Person::getAge));

注意:Person::getAge 必须返回 int(或自动拆箱的 Integer),不能是 long 或 double,否则编译报错 no suitable method found for summarizingInt(...)。

  • 支持的方法引用、Lambda、匿名内部类,只要类型匹配 ToIntFunction
  • 如果字段可能为 null(如 Integer age),而你又没做空值处理,运行时会抛 NullPointerException
  • 均值(getAverage())返回 double,但它是精确计算结果(非截断),小数位数取决于原始数据精度

拿到结果后怎么取值?别调 toString() 就完事

IntSummaryStatistics 是个不可变容器,提供明确的 getter 方法,不是靠解析字符串:

System.out.println(stats.getCount());     // long,不是 int
System.out.println(stats.getSum());       // long,防溢出设计
System.out.println(stats.getAverage());   // double,空集合时返回 0.0
System.out.println(stats.getMin());       // int,空集合时返回 Integer.MAX_VALUE
System.out.println(stats.getMax());       // int,空集合时返回 Integer.MIN_VALUE

关键点:

Java 接口排错助手
Java 接口排错助手

在调试 Java 后端 API 故障时使用此技能,尤其适用于以下任务:分析日志、跨 Controller、Service 和 Mapper 层追踪请求、定位异常根因、检查 SQL 执行或参数流转,以及生成简洁的诊断结论与修复方案。

下载
  • getSum() 返回 long——这是为了在累加过程中避免 int 溢出,但你传入的每个值仍是 int 范围内
  • 空集合时,getMin()/getMax() 的返回值是哨兵值,不是 Optional,需自行判断 getCount() == 0 再决定是否使用极值
  • getAverage() 对空集合返回 0.0,不是 NaN,这点和直觉相反,容易埋坑

替代方案对比:为什么不用 summarizingLong() 或手动 reduce?

如果你的数据本质是 long(比如毫秒时间戳、ID),硬套 summarizingInt() 会丢失精度或抛异常;这时该用 Collectors.summarizingLong() ——接口完全一致,只是泛型参数和返回类型不同。

手动 reduce() 实现同样功能?可以,但代价高:

  • 要自己定义五元组类或用 AbstractMap.SimpleImmutableEntry 拼凑
  • 合并逻辑复杂(尤其均值和极值的并发安全合并),IntSummaryStatistics 内部已优化为无锁、可并行的累积器
  • Stream 并行时,summarizingInt() 自动适配 ForkJoinPool 分段统计再合并,手动写极易出错

真正容易被忽略的是:它只做「单字段」统计。想同时按城市分组再对每个城市的销售额做汇总?得嵌套用——先 groupingBy(city, summarizingInt(sale::getAmount)),而不是幻想一个 collector 能跨维度聚合。

Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南

相关专题

更多
java
java

Java是一个通用术语,用于表示Java软件及其组件,包括“Java运行时环境 (JRE)”、“Java虚拟机 (JVM)”以及“插件”。php中文网还为大家带了Java相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

2023.06.15

11957

6

java正则表达式语法
java正则表达式语法

java正则表达式语法是一种模式匹配工具,它非常有用,可以在处理文本和字符串时快速地查找、替换、验证和提取特定的模式和数据。本专题提供java正则表达式语法的相关文章、下载和专题,供大家免费下载体验。

2023.07.05

9042

9

java自学难吗
java自学难吗

Java自学并不难。Java语言相对于其他一些编程语言而言,有着较为简洁和易读的语法,本专题为大家提供java自学难吗相关的文章,大家可以免费体验。

2023.07.31

7752

8

java配置jdk环境变量
java配置jdk环境变量

Java是一种广泛使用的高级编程语言,用于开发各种类型的应用程序。为了能够在计算机上正确运行和编译Java代码,需要正确配置Java Development Kit(JDK)环境变量。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.08.01

1264

3

java保留两位小数
java保留两位小数

Java是一种广泛应用于编程领域的高级编程语言。在Java中,保留两位小数是指在进行数值计算或输出时,限制小数部分只有两位有效数字,并将多余的位数进行四舍五入或截取。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.08.02

1008

3

java基本数据类型
java基本数据类型

java基本数据类型有:1、byte;2、short;3、int;4、long;5、float;6、double;7、char;8、boolean。本专题为大家提供java基本数据类型的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.02

1516

5

java有什么用
java有什么用

java可以开发应用程序、移动应用、Web应用、企业级应用、嵌入式系统等方面。本专题为大家提供java有什么用的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.02

3129

5

java在线网站
java在线网站

Java在线网站是指提供Java编程学习、实践和交流平台的网络服务。近年来,随着Java语言在软件开发领域的广泛应用,越来越多的人对Java编程感兴趣,并希望能够通过在线网站来学习和提高自己的Java编程技能。php中文网给大家带来了相关的视频、教程以及文章,欢迎大家前来学习阅读和下载。

2023.08.03

20371

3

配置java环境变量
配置java环境变量

配置Java环境变量是为了让操作系统能够识别和使用Java的相关命令和功能。本专题为大家提供配置java环境变量相关文章,帮助大家解决问题。

2023.08.03

1375

8

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
dev.java 官方:Learn Java
dev.java 官方:Learn Java

共0课时 | 0人学习

Java JDBC数据库连接官方教程
Java JDBC数据库连接官方教程

共0课时 | 0人学习