Java CompletableFuture如何实现按指定完成比例返回结果
基于原生Java能力实现按指定成功数返回的CompletableFuture聚合能力
完全可以通过原生CompletableFuture与JUC并发工具实现,不需要引入第三方依赖,语义和Bluebird JS的Promise.some能力完全对齐,可精准匹配分布式多节点写入的一致性校验需求。
核心实现逻辑
- 仅计数成功完成的子任务,异常失败的任务不计入阈值统计
- 当成功数达到预先设定的阈值(对应要求的副本写入百分比)时,立即触发主流程返回,携带所有已成功的执行结果
- 内置兜底判断:当剩余未执行的任务即使全部成功,也无法凑够阈值时,直接触发整体流程失败,避免无意义等待
- 支持在达到阈值后,自动取消剩余未执行完成的任务,减少不必要的网络、线程资源消耗
具体实现代码
public static <T> CompletableFuture<List<T>> some(Collection<CompletableFuture<T>> tasks, int requiredSuccessCount) { int totalTaskCount = tasks.size(); // 前置参数校验 if (requiredSuccessCount > totalTaskCount) { return CompletableFuture.failedFuture(new IllegalArgumentException("要求的成功节点数超过总任务数")); } if (requiredSuccessCount <= 0) { return CompletableFuture.completedFuture(Collections.emptyList()); } // 线程安全集合存储已成功的执行结果 List<T> successResultList = Collections.synchronizedList(new ArrayList<>(requiredSuccessCount)); // 线程安全计数器,记录已成功完成的任务数 AtomicInteger successCounter = new AtomicInteger(0); // 对外返回的主Future,满足条件时完成该Future即可 CompletableFuture<List<T>> mainFuture = new CompletableFuture<>(); for (CompletableFuture<T> task : tasks) { // 为每个子任务注册完成回调,无论成功失败都会触发 task.whenComplete((result, throwable) -> { // 主Future已完成时直接跳过,避免重复触发逻辑 if (mainFuture.isDone()) { return; } // 子任务执行成功 if (throwable == null) { int currentSuccessCount = successCounter.incrementAndGet(); successResultList.add(result); // 达到要求的成功数,完成主Future if (currentSuccessCount == requiredSuccessCount) { mainFuture.complete(new ArrayList<>(successResultList)); // 可选:取消剩余未执行完成的任务,避免资源空耗 tasks.forEach(t -> { if (!t.isDone()) { t.cancel(true); } }); } } else { // 子任务执行失败,计算剩余可达成的最大成功数是否能满足阈值 int remainingMaxPossibleSuccess = totalTaskCount - successCounter.get() - 1; if (successCounter.get() + remainingMaxPossibleSuccess < requiredSuccessCount) { // 永远无法达到要求的成功数,直接标记主Future为失败 mainFuture.completeExceptionally(new IllegalStateException("无法满足要求的副本写入成功数")); } } }); } return mainFuture; }
使用示例
对应10个节点并行写入的场景,要求60%(即6个)节点写入成功即满足一致性要求:
// 自定义ThreadPoolExecutor执行写入任务 ThreadPoolExecutor writeExecutor = new ThreadPoolExecutor(...); // 构建10个节点的写入任务 List<CompletableFuture<WriteResult>> writeTasks = nodeList.stream() .map(node -> CompletableFuture.supplyAsync(() -> node.write(data), writeExecutor)) .toList(); // 要求6个节点写入成功即返回 CompletableFuture<List<WriteResult>> writeProcessFuture = some(writeTasks, 6); writeProcessFuture.thenAccept(successNodes -> { // 达到一致性要求,返回写入成功结果 System.out.println("已在" + successNodes.size() + "个节点完成写入,满足副本一致性要求"); }).exceptionally(ex -> { // 未达到一致性要求,触发失败逻辑 System.out.println("写入失败:" + ex.getMessage()); return null; });
适配说明
- 该实现和自定义
ThreadPoolExecutor完全兼容:无需调整线程池的核心配置,只需要将写入任务提交为独立的CompletableFuture实例传入聚合方法即可 - 完全基于原生
CompletableFuture的回调机制实现,和anyOf、allOf的底层执行模型一致,不存在能力冲突 - 逻辑可灵活调整:如果不需要自动取消剩余任务,直接删除代码中的任务取消逻辑块即可;如果需要传递更细粒度的异常信息,可在失败分支自定义异常类型
内容的提问来源于stack exchange,提问作者stewartie4
相关产品推荐
相关产品推荐

