java 的 countdownlatch 可以让一个线程等待多个任务把计数减到零。每个任务应在 finally 中调用 countdown(),主线程用带超时的 await() 判断是否等完;计数归零只说明任务到达了结束点,任务是否成功仍需单独记录。以下示例适用于 jdk 17。

创建计数器,并在任务结束时减少计数
保存为 LatchDemo.java。两个任务分别模拟成功和失败,通过线程安全队列保存结果。只有 await 返回 true 才读取完整结果;如果超时或主线程中断,finally 会尝试中断剩余任务。队列的输出顺序不固定。
import java.util.concurrent.*;
public class LatchDemo {
public static void main(String[] args) {
CountDownLatch done = new CountDownLatch(2);
ConcurrentLinkedQueue<string> results = new ConcurrentLinkedQueue();
ExecutorService pool = Executors.newFixedThreadPool(2);
try {
for (int i = 0; i {
try {
if (id == 1) throw new IllegalStateException("模拟失败");
results.add("任务 " + id + " 成功");
} catch (Exception error) {
results.add("任务 " + id + " 失败:" + error.getMessage());
} finally {
done.countDown();
}
});
}
boolean finished = done.await(2, TimeUnit.SECONDS);
if (finished) {
results.forEach(System.out::println);
} else {
System.out.println("等待超时,结果可能不完整");
}
} catch (InterruptedException error) {
Thread.currentThread().interrupt();
System.out.println("主线程等待被中断");
} finally {
pool.shutdownNow();
}
}
}</string>

验证 await 超时后不会自动取消任务
保存为 LatchTimeout.java。第一次 await 使用零等待,任务尚未提交,结果必为 false;随后提交任务并再次等待,观察计数器仍可继续使用。CountDownLatch 不能重置,计数归零后的 await 会立即返回。
import java.util.concurrent.*;
public class LatchTimeout {
public static void main(String[] args) throws InterruptedException {
CountDownLatch done = new CountDownLatch(1);
ExecutorService pool = Executors.newSingleThreadExecutor();
try {
System.out.println(done.await(0, TimeUnit.MILLISECONDS)); // false
System.out.println(done.getCount()); // 1
pool.submit(done::countDown);
System.out.println(done.await(2, TimeUnit.SECONDS)); // 通常 true
} finally {
pool.shutdownNow();
}
}
}
await 超时只结束当前等待,不会减少计数或取消子任务。shutdownNow 也只是发出中断请求;任务需要配合中断,涉及网络或文件操作还应设置相应超时。
编译运行,并分别检查成功、失败和超时输出
在安装 JDK 17 的环境下执行以下命令。第一个示例应打印一项成功和一项失败,说明“等待完成”不能等同“全部成功”;第二个示例前两行固定为 false 和 1,最后一行取决于两秒内任务是否被调度完成。
javac LatchDemo.java LatchTimeout.java java LatchDemo # 两行结果顺序不固定: # 任务 0 成功 # 任务 1 失败:模拟失败 java LatchTimeout # false # 1 # 正常调度时接着输出 true
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南











