doublesummarystatistics专为doublestream聚合统计设计,适用于需同时获取平均值、最值、总和、元素个数等多指标的场景;必须通过collectors.summarizingdouble()创建,空流返回默认值需谨慎判断。

DoubleSummaryStatistics 适合统计什么场景
它专为 double 类型的数值流(DoubleStream)做聚合统计,比如求平均值、最大最小值、总和、元素个数。不是用来处理 Double 对象列表或普通数组的——那得先转成流;也不是替代 Math 工具类的单次计算,而是当你已经用上 stream() 且需要一揽子统计结果时才值得用。
常见错误现象:NullPointerException 出现在流为空时调用 getAverage()?不,它返回 double,空流下 getAverage() 是 0.0,但语义上不合理——这点后面会强调。
怎么创建并获取统计结果
必须通过 Collectors.summarizingDouble() 触发收集,不能直接 new。它本质是个收集器(Collector),不是工具类。
- 正确写法:
DoubleSummaryStatistics stats = list.stream().collect(Collectors.summarizingDouble(Double::doubleValue)); - 错误写法:
new DoubleSummaryStatistics()—— 构造函数是 package-private,外部不可见 - 注意参数:
summarizingDouble接收的是ToDoubleFunction,所以对象字段要能转成double,比如item -> item.value或MyObj::getPrice
空流时的统计值陷阱
DoubleSummaryStatistics 对空流返回的不是“未定义”,而是“有默认值”:个数是 0,总和是 0.0,平均值是 0.0,最大最小值是 Double.NEGATIVE_INFINITY 和 Double.POSITIVE_INFINITY。这容易掩盖逻辑漏洞。
立即学习“Java免费学习笔记(深入)”;
- 检查是否为空流:用
stats.getCount() == 0判断,别依赖getAverage() == 0.0 - 如果业务上空流应报错或跳过,得在 collect 前加
if (list.isEmpty()) throw ...或用Optional.ofNullable(...).filter(...) - 性能影响:无额外开销,但默认值设计会让空流统计“看起来成功了”,反而难 debug
和原始 double 数组/循环统计比有什么区别
它不比手写 for 循环快,也不比 DoubleStream.of(...).average() 更省内存——它只是把多次遍历压缩成一次,避免重复走流管道。
- 适用条件:你本来就要对同一数据流做 ≥2 个统计(比如既要均值又要极差),这时用
summarizingDouble比分别调mapToDouble(...).average()、.max()省事且高效 - 不适用情况:只求一个值(如只要 sum),直接用
mapToDouble(...).sum()更直白,少一层对象封装 - 兼容性:JDK 8+,无第三方依赖;但注意
DoubleSummaryStatistics不实现Serializable,跨进程传要自己处理
真正容易被忽略的点是:它的 toString() 输出带括号和逗号,比如 DoubleSummaryStatistics{count=3, sum=6.000000, min=1.000000, average=2.000000, max=3.000000},看着像可读格式,但没提供结构化取值方法(比如没有 getAsMap()),要用哪个值就得显式调对应 getter。










