collectors.reducing 是 java stream 中用于分组后复杂归约的灵活工具,提供单、双、三参数三种用法,分别适用于非空组同类型归约、带默认值归约、以及支持类型转换与自定义合并的高级归约场景。

Java Stream API 的 Collectors.reducing 是一种灵活但易被低估的归约工具,特别适合在分组(groupingBy)后对每组数据执行非标准聚合——比如计算加权平均、拼接带分隔符的字符串、求最大差值、或组合多个字段生成复合对象。关键在于理解 reducing 的三个重载版本及其与分组的配合逻辑。
明确 reducing 的三种用法场景
Collectors.reducing 提供三个主要签名,选择取决于是否允许空组、是否需要初始值、以及归约逻辑是否需保持类型一致:
-
单参数版:
reducing(BinaryOperator<t>)</t>—— 要求组内至少一个元素,否则抛NullPointerException;适用于非空集合且归约结果类型与元素类型相同(如Integer::sum) -
双参数版:
reducing(T identity, BinaryOperator<t>)</t>—— 提供默认值,空组返回该值;适合数值累加、字符串拼接等有自然零值的场景 -
三参数版:
reducing(U identity, Function super T, ? extends U> mapper, BinaryOperator<u> combiner)</u>—— 最强大:支持类型转换(mapper)、自定义初始值(identity)、以及合并逻辑(combiner),是处理复杂归约的核心
用三参数 reducing 实现带权重的组内平均
例如按部门分组,计算每个部门员工的「加权薪资平均值」(权重为工龄):
Map<string double> deptWeightedAvg = employees.stream()
.collect(Collectors.groupingBy(
Employee::getDept,
Collectors.reducing(
0.0, // 初始值(总加权和)
e -> e.getSalary() * e.getYearsOfService(), // 映射:薪资 × 工龄
Double::sum // 合并:累加所有加权值
)
))
.entrySet().stream()
.collect(Collectors.toMap(
Map.Entry::getKey,
entry -> entry.getValue() /
employees.stream()
.filter(e -> e.getDept().equals(entry.getKey()))
.mapToDouble(Employee::getYearsOfService)
.sum()
));</string>
⚠️ 注意:上面写法效率低(重复遍历)。更优解是用三参数 reducing 同时累积加权和与总权重:
Java JDK 25 来自 OpenJDK 官方归档,版本为 JDK 25,本条下载地址已指向官方 Windows x64 zip 安装包直链,适合调试旧项目或兼容旧版 Java 运行环境。
record WeightedSum(double sum, double weight) {}
Map<string double> deptWeightedAvg = employees.stream()
.collect(Collectors.groupingBy(
Employee::getDept,
Collectors.reducing(
new WeightedSum(0.0, 0.0),
e -> new WeightedSum(e.getSalary() * e.getYearsOfService(), e.getYearsOfService()),
(a, b) -> new WeightedSum(a.sum() + b.sum(), a.weight() + b.weight())
)
))
.entrySet().stream()
.collect(Collectors.toMap(
Map.Entry::getKey,
e -> e.getValue().weight() == 0 ? 0.0 : e.getValue().sum() / e.getValue().weight()
));</string>
用 reducing 拼接带序号和分隔符的字符串
分组后生成类似 "[1] Alice, [2] Bob, [3] Charlie" 的格式,需维护序号状态。由于 reducing 要求无状态,可借助 AtomicInteger(仅限单线程流)或改用 collect(Supplier, BiConsumer, BiConsumer)。但若坚持 reducing,可预生成索引再映射:
List<employee> list = new ArrayList(employees);
Map<string string> deptNames = list.stream()
.collect(Collectors.groupingBy(
Employee::getDept,
Collectors.reducing(
"",
e -> String.format("[%d] %s", list.indexOf(e) + 1, e.getName()),
(a, b) -> a.isEmpty() ? b : a + ", " + b
)
));</string></employee>
更健壮的方式是先分组再对每组内部排序编号:
Map<string string> deptNames = employees.stream()
.collect(Collectors.groupingBy(
Employee::getDept,
Collectors.collectingAndThen(
Collectors.toList(),
list -> IntStream.range(0, list.size())
.mapToObj(i -> String.format("[%d] %s", i + 1, list.get(i).getName()))
.collect(Collectors.joining(", "))
)
));</string>
避免常见陷阱:空组、类型擦除与并发安全
使用 reducing 时需警惕三点:
- 空组问题:双/三参数版可设合理 identity(如 0L、""、Optional.empty()),单参数版遇到空组直接失败
-
泛型擦除干扰:若 mapper 返回泛型类(如
Pair<k></k>),务必显式声明类型,避免编译错误:reducing(new Pair("", 0), ...) - 并发不安全:reducing 本身是无状态的,但若在 parallelStream 中使用可变对象(如 StringBuilder),必须确保 combiner 正确合并;优先选用不可变中间类型(如 String、Long)
reducing 不是万能替代品,但它在需要精细控制归约过程的分组场景中极具表现力。真正掌握它,关键不是背签名,而是想清楚「每组要产出什么」「如何把原始元素变成可累加的中间形态」「怎么把中间结果合成最终值」——这三步理清了,代码自然清晰。
大量免费API接口:立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游,为数据API应用能力赋能!










