public class CountDownLatch

extends Object

允许一个或多个线程等待直到在其他线程中执行的一组操作完成的同步辅助。

​CountDownLatch​​用给定的​计数​初始化。 ​​await​​​方法阻塞,直到由于​​countDown()​​​方法的​​调用​​​而导致当前计数达到零,之后所有等待线程被释放,并且任何后续的​​await​​​ ​​调用立即​​​返回。 这是一个一次性的现象 - 计数无法重置。 如果您需要重置计数的版本,请考虑使用​​CyclicBarrier​​ 。

​CountDownLatch​​​是一种通用的同步工具,可用于多种用途。 一个​​CountDownLatch​​​为一个计数的CountDownLatch用作一个简单的开/关锁存器,或者门:所有线程调用​​await​​​在门口等待,直到被调用​​countDown()​​​的线程打开。 一个​​CountDownLatch​​初始化​N​可以用来做一个线程等待,直到​N个​线程完成某项操作,或某些动作已经完成N次。

​CountDownLatch​​​一个有用的属性是,它不要求调用​​countDown​​​线程等待计数到达零之前继续,它只是阻止任何线程通过​​await​​ ,直到所有线程可以通过。

示例用法:​这是一组类,其中一组工作线程使用两个倒计时锁存器:


  • 第一个是启动信号,防止任何工作人员进入,直到驾驶员准备好继续前进;
  • 第二个是完成信号,允许司机等到所有的工作人员完成。

另一个典型的用法是将问题划分为N个部分,用一个Runnable来描述每个部分,该Runnable执行该部分并在锁存器上倒计时,并将所有Runnables排队到执行器。 当所有子部分完成时,协调线程将能够通过等待。 (当线程必须以这种方式反复倒数时,请​​改用​​CyclicBarrier​​ ))

内存一致性效果:直到计数调用之前达到零,在一个线程操作​​countDown()​​​ ​happen-before​​以下由相应的成功返回行动​​await()​​在另一个线程。

构造方法

构造方法和描述

​CountDownLatch​​(int count)​

构造一个以给定计数 ​​CountDownLatch​​ CountDownLatch。


方法

类型和参数

方法和描述

​void​

​await​​()​

导致当前线程等到锁存器计数到零,除非线程是 ​​interrupted​​ 。


​boolean​

​await​​(long timeout, ​​TimeUnit​​ unit)​

使当前线程等待直到锁存器计数到零为止,除非线程为 ​​interrupted​​或指定的等待时间过去。


​void​

​countDown​​()​

减少锁存器的计数,如果计数达到零,释放所有等待的线程。


​long​

​getCount​​()​

返回当前计数。


​String​

​toString​​()​

返回一个标识此锁存器的字符串及其状态。


import java.util.concurrent.CountDownLatch;

/*
* CountDownLatch :闭锁,在完成某些运算是,只有其他所有线程的运算全部完成,当前运算才继续执行
*/
public class TestCountDownLatch {

public static void main(String[] args) {
final CountDownLatch latch = new CountDownLatch(50);
LatchDemo ld = new LatchDemo(latch);

long start = System.currentTimeMillis();

for (int i = 0; i < 50; i++) {
new Thread(ld).start();
}

try {
latch.await();
} catch (InterruptedException e) {
}

long end = System.currentTimeMillis();

System.out.println("耗费时间为:" + (end - start));
}

}

class LatchDemo implements Runnable {

private CountDownLatch latch;

public LatchDemo(CountDownLatch latch) {
this.latch = latch;
}

@Override
public void run() {

try {
for (int i = 0; i < 50000; i++) {
if (i % 2 == 0) {
System.out.println(i);
}
}
} finally {
latch.countDown();
}

}

}