JavaCollectors.summarizingDouble用法详解

你在学习文章相关的知识吗？本文《Java中使用Collectors.summarizingDouble统计Double集合方法详解》，主要介绍的内容就涉及到，如果你想提升自己的开发能力，就不要错过这篇文章，大家要知道编程理论基础和实战操作都是不可或缺的哦！

Collectors.summarizingDouble用于提取对象中的double值并生成统计信息，返回DoubleSummaryStatistics对象，包含count、sum、min、max和average；需传入ToDoubleFunction函数式接口实现值提取，常用于如商品价格等数值统计场景；若数据源可能为null，应先通过filter(Objects::nonNull)或过滤逻辑避免NullPointerException；对List可结合Double::doubleValue使用，确保安全处理null元素。

在Java中，Collectors.summarizingDouble 是一个非常实用的收集器（Collector），用于对集合中的元素进行汇总统计，特别适用于需要获取最大值、最小值、平均值、总和和元素数量等信息的场景。虽然名字中带有“Double”，但它主要用于从对象中提取 double 类型的值进行统计，而不是直接处理 Double 集合本身。

1. 方法作用说明

Collectors.summarizingDouble 接收一个函数式接口 ToDoubleFunction，该函数用于从集合中的每个元素提取一个 double 值。然后返回一个 DoubleSummaryStatistics 对象，包含以下统计信息：

• count：元素个数
• sum：所有提取值的总和
• min：最小值
• max：最大值
• average：平均值（如果为空则为 Double.NaN）

2. 基本使用示例

假设有一个商品类 Product，我们想统计其价格（Double 类型）的汇总信息：

class Product {
    private String name;
    private Double price;

    public Product(String name, Double price) {
        this.name = name;
        this.price = price;
    }

    public Double getPrice() {
        return price;
    }
}

使用 Collectors.summarizingDouble 进行统计：

List<Product> products = Arrays.asList(
    new Product("A", 10.5),
    new Product("B", 20.3),
    new Product("C", 15.0)
);

DoubleSummaryStatistics stats = products.stream()
    .collect(Collectors.summarizingDouble(Product::getPrice));

System.out.println(stats);
// 输出：
// DoubleSummaryStatistics{count=3, sum=45.800000, min=10.500000, average=15.266667, max=20.300000}

3. 处理 null 或空集合的情况

需要注意的是，如果集合中某个元素的提取值为 null，会抛出 NullPointerException。例如，当 price 为 null 时：

new Product("D", null) // 调用 getPrice() 返回 null，在 summarizingDouble 中会报错

为了避免这个问题，可以先过滤掉 null 值，或转换为 0.0：

DoubleSummaryStatistics stats = products.stream()
    .filter(p -> p.getPrice() != null) // 过滤 null
    .collect(Collectors.summarizingDouble(Product::getPrice));

4. 直接对 Double 集合使用的方法

如果你有一个 List，可以直接通过方法引用 Double::doubleValue 来使用：

List<Double> values = Arrays.asList(1.1, 2.2, 3.3, null, 4.4);

DoubleSummaryStatistics stats = values.stream()
    .filter(Objects::nonNull) // 排除 null
    .collect(Collectors.summarizingDouble(Double::doubleValue));

System.out.println("Count: " + stats.getCount());
System.out.println("Sum: " + stats.getSum());
System.out.println("Average: " + stats.getAverage());
System.out.println("Min: " + stats.getMin());
System.out.println("Max: " + stats.getMax());

基本上就这些。只要理解了 summarizingDouble 的核心是“提取 double 值并统计”，就能灵活应用于各种对象集合或原始类型包装类的汇总需求。注意处理 null 值，避免运行时异常。

好了，本文到此结束，带大家了解了《JavaCollectors.summarizingDouble用法详解》，希望本文对你有所帮助！关注golang学习网公众号，给大家分享更多文章知识！