Java中Collectors.summarizingLong用法详解

本文详解Java中使用`Collectors.summarizingLong`统计Long集合的方法。`Collectors.summarizingLong`是Java Stream API中强大的工具，用于高效统计Long类型集合的汇总信息，如数量、总和、最小值、最大值及平均值。它通过`LongSummaryStatistics`对象返回统计结果，避免多次遍历集合，提升性能。文章将深入探讨其基本语法、使用示例，包括直接统计Long类型集合以及处理对象集合中的Long字段。同时，也会介绍使用时的注意事项和适用场景，助您在数据聚合和报表生成等业务中灵活运用，提升代码效率和可读性。

Collectors.summarizingLong用于统计集合中long值的汇总信息，返回LongSummaryStatistics对象，可获取数量、总和、最值及平均值。

在Java中，Collectors.summarizingLong 是一个非常实用的收集器，用于对集合中的元素进行统计操作，特别适用于需要获取最大值、最小值、总和、平均值以及元素数量等汇总信息的场景。它常与 Stream API 配合使用，返回一个 LongSummaryStatistics 对象，包含所有统计结果。

1. 基本语法与返回类型

Collectors.summarizingLong 接收一个函数式接口 ToLongFunction，该接口用于从集合元素中提取出 long 类型的值。其基本语法如下：

stream.collect(Collectors.summarizingLong(ToLongFunction mapper))

返回的是一个 LongSummaryStatistics 实例，可通过以下方法获取统计信息：

• getCount()：元素数量
• getSum()：总和
• getMin()：最小值（若无元素则返回 Long.MAX_VALUE）
• getMax()：最大值（若无元素则返回 Long.MIN_VALUE）
• getAverage()：平均值（空集合返回 0.0）

2. 统计 Long 类型集合的示例

假设有一个 List，我们想统计其中所有数值的汇总信息：

import java.util.*;
import java.util.stream.Collectors;

public class LongSummaryExample {
    public static void main(String[] args) {
        List<Long> numbers = Arrays.asList(10L, 20L, 30L, 40L, 50L);

        LongSummaryStatistics stats = numbers.stream()
            .collect(Collectors.summarizingLong(Long::longValue));

        System.out.println("总数: " + stats.getCount());
        System.out.println("总和: " + stats.getSum());
        System.out.println("最小值: " + stats.getMin());
        System.out.println("最大值: " + stats.getMax());
        System.out.println("平均值: " + stats.getAverage());
    }
}

输出结果为：

总数: 5
总和: 150
最小值: 10
最大值: 50
平均值: 30.0

3. 处理对象集合中的 Long 字段

更常见的用法是处理对象列表，例如统计用户年龄或订单金额等。假设有如下类：

class User {
    private String name;
    private long age;

    public User(String name, long age) {
        this.name = name;
        this.age = age;
    }

    public long getAge() {
        return age;
    }
    // getter 和 setter 省略
}

统计用户年龄的汇总信息：

List<User> users = Arrays.asList(
    new User("Alice", 25L),
    new User("Bob", 30L),
    new User("Charlie", 35L)
);

LongSummaryStatistics ageStats = users.stream()
    .collect(Collectors.summarizingLong(User::getAge));

System.out.println("用户数: " + ageStats.getCount());
System.out.println("总年龄: " + ageStats.getSum());
System.out.println("最年轻: " + ageStats.getMin());
System.out.println("最年长: " + ageStats.getMax());
System.out.println("平均年龄: " + ageStats.getAverage());

4. 注意事项与适用场景

使用 summarizingLong 时需注意以下几点：

• 传入的函数必须返回 long 类型，不能是 null，否则会抛出 NullPointerException
• 空集合不会抛异常，但 min/max 会有默认值，平均值为 0.0
• 适合需要多项统计的场景，避免多次遍历集合计算 sum、max 等
• 性能优于分别调用 mapToInt().sum()、max() 等多次终端操作

基本上就这些。这个收集器简洁高效，特别适合在数据聚合、报表生成等业务中使用。只要确保提取字段非 null，就能安全使用。

到这里，我们也就讲完了《Java中Collectors.summarizingLong用法详解》的内容了。个人认为，基础知识的学习和巩固，是为了更好的将其运用到项目中，欢迎关注golang学习网公众号，带你了解更多关于的知识点！