runaftereither 用于在当前 completablefuture 或另一个给定的 completablefuture 任意一个完成时，执行一个无返回值的 runnable 任务。它不会阻塞当前线程，而是异步地触发后续逻辑，非常适合处理并发任务中“任一结果就绪即触发”的场景。
基本用法与参数含义
该方法接收两个参数：第一个是另一个 CompletableFuture 对象，第二个是 Runnable 接口实现。当调用该方法的实例或者传入的 CompletableFuture 任意一个完成（无论是正常返回还是异常结束），传入的 Runnable 就会被执行。需要注意的是，runAfterEither 本身返回一个新的 CompletableFuture<void></void>，这个新 Future 在 Runnable 执行完毕后完成。
import java.util.concurrent.CompletableFuture;
import java.util.concurrent.ExecutionException;
public class RunAfterEitherDemo {
public static void main(String[] args) throws ExecutionException, InterruptedException {
// 模拟两个耗时不同的任务
CompletableFuture<String> taskA = CompletableFuture.supplyAsync(() -> {
try { Thread.sleep(1000); } catch (InterruptedException e) {}
return "Task A Result";
});
CompletableFuture<String> taskB = CompletableFuture.supplyAsync(() -> {
try { Thread.sleep(500); } catch (InterruptedException e) {}
return "Task B Result";
});
// 使用 runAfterEither：当 taskA 或 taskB 任意一个完成时，执行打印操作
CompletableFuture<Void> future = taskA.runAfterEither(taskB, () -> {
System.out.println("One of the tasks completed. Triggering action.");
});
// 等待最终动作完成
future.get();
System.out.println("Main thread continues...");
}
}
异常处理与返回值类型
由于 runAfterEither 接受的是 Runnable，它不能返回任何值，因此其返回类型固定为 CompletableFuture<void></void>。如果参与比较的两个原始 Future 中有一个抛出了异常，runAfterEither 依然会触发执行，但需要确保 Runnable 内部做好异常捕获，否则可能导致未处理的异常中断后续链式调用。若需获取具体是哪个任务完成并传递结果，应改用 acceptEither 方法。
你是 TypeScript 项目架构专家，专注于脚手架搭建生产就绪的 Node.js 和前端应用。生成包含现代工具链（pnpm、Vite、Next.js）、类型
立即学习“Java免费学习笔记（深入）”；
import java.util.concurrent.CompletableFuture;
public class RunAfterEitherWithException {
public static void main(String[] args) {
CompletableFuture<String> failingTask = CompletableFuture.supplyAsync(() -> {
throw new RuntimeException("Simulated Failure");
});
CompletableFuture<String> successTask = CompletableFuture.supplyAsync(() -> {
return "Success";
});
// 即使 failingTask 抛出异常，runAfterEither 仍会执行
failingTask.runAfterEither(successTask, () -> {
System.out.println("Action triggered despite exception in one of the futures.");
});
// 注意：这里不阻塞，实际项目中通常结合 join() 或 get() 监控状态
try { Thread.sleep(2000); } catch (InterruptedException e) {}
}
}
基于输入条件判断执行时机
在实际业务中，常需根据哪个任务先完成来执行不同逻辑。虽然 runAfterEither 本身不区分来源，但可以通过共享变量或结合 whenComplete 来实现差异化处理。例如，若希望仅在特定任务完成时才触发清理工作，可在 Runnable 中检查状态标志位，确保逻辑符合预期输入条件下的行为。
