CountDownLatch（倒计时计数器）使用说明

方法说明：

 

public void countDown()

     递减锁存器的计数，如果计数到达零，则释放所有等待的线程。如果当前计数大于零，则将计数减少。如果新的计数为零，出于线程调度目的，将重新启用所有的等待线程。

     如果当前计数等于零，则不发生任何操作。

public boolean await(long timeout, TimeUnit unit)throws InterruptedException
     使当前线程在锁存器倒计数至零之前一直等待，除非线程被中断或超出了指定的等待时间。如果当前计数为零，则此方法立刻返回 true 值。

     如果当前计数大于零，则出于线程调度目的，将禁用当前线程，且在发生以下三种情况之一前，该线程将一直处于休眠状态：

         由于调用 countDown() 方法，计数到达零；或者其他某个线程中断当前线程；或者已超出指定的等待时间。

          * 如果计数到达零，则该方法返回 true 值。

          * 如果当前线程，在进入此方法时已经设置了该线程的中断状态；或者在等待时被中断， 则抛出 InterruptedException，并且清除当前线程的已中断状态。

          * 如果超出了指定的等待时间，则返回值为 false。如果该时间小于等于零，则此方法根本不会等待。

    
     参数：

         timeout - 要等待的最长时间

         unit - timeout 参数的时间单位。

     返回：

         如果计数到达零，则返回 true；如果在计数到达零之前超过了等待时间，则返回 false

     抛出：

          InterruptedException - 如果当前线程在等待时被中断

 

例子1：

     主线程等待子线程执行完成在执行。

     

import java.util.concurrent.CountDownLatch;
import java.util.concurrent.ExecutorService;
import java.util.concurrent.Executors;
 
public class CountdownLatchTest1 {
 
        public static void main(String[] args) {
              ExecutorService service = Executors. newFixedThreadPool(3);
               final CountDownLatch latch = new CountDownLatch(3);
               for (int i = 0; i < 3; i++) {
                     Runnable runnable = new Runnable() {
                           
                            @Override
                            public void run() {
                                   try {
                                         System. out.println("子线程" + Thread.currentThread().getName() + "开始执行");
                                         Thread. sleep((long) (Math. random() * 10000));
                                         System. out.println("子线程" + Thread.currentThread().getName() + "执行完成");
                                         latch.countDown(); // 当前线程调用此方法，则计数减一
                                  } catch (InterruptedException e) {
                                         e.printStackTrace();
                                  }
                           }
                     };
                     service.execute(runnable);
              }
              
               try {
                     System. out.println("主线程" + Thread.currentThread().getName() + "等待子线程执行完成..." );
                     latch.await(); // 阻塞当前线程，直到计时器的值为0
                     System. out.println("主线程" + Thread.currentThread().getName() + "开始执行...");
              } catch (InterruptedException e) {
                     e.printStackTrace();
              }
       }
}

 

例子2：

     百米赛跑，4名运动员选手到达场地等待裁判口令，裁判一声口令，选手听到后同时起跑，当所有选手到达终点，裁判进行汇总汇总排名。

 

import java.util.concurrent.CountDownLatch;
import java.util.concurrent.ExecutorService;
import java.util.concurrent.Executors;
 
public class CountdownLatchTest2 {
 
        public static void main(String[] args) {
              ExecutorService service = Executors. newCachedThreadPool();
               final CountDownLatch cdOrder = new CountDownLatch(1);
               final CountDownLatch cdAnswer = new CountDownLatch(4);
               for (int i = 0; i < 4; i++) {
                     Runnable runnable = new Runnable() {
                            public void run() {
                                   try {
                                         System. out.println("选手" + Thread.currentThread().getName() + "正等待裁判发布口令");
                                         cdOrder.await();
                                         System. out.println("选手" + Thread.currentThread().getName() + "已接受裁判口令");
                                         Thread. sleep((long) (Math. random() * 10000));
                                         System. out.println("选手" + Thread.currentThread().getName() + "到达终点");
                                         cdAnswer.countDown();
                                  } catch (Exception e) {
                                         e.printStackTrace();
                                  }
                           }
                     };
                     service.execute(runnable);
              }
               try {
                     Thread. sleep((long) (Math. random() * 10000));
 
                     System. out.println("裁判" + Thread.currentThread ().getName() + "即将发布口令" );
                     cdOrder.countDown();
                     System. out.println("裁判" + Thread.currentThread ().getName() + "已发送口令，正在等待所有选手到达终点" );
                     cdAnswer.await();
                     System. out.println("所有选手都到达终点" );
                     System. out.println("裁判" + Thread.currentThread ().getName() + "汇总成绩排名" );
              } catch (Exception e) {
                     e.printStackTrace();
              }
              service.shutdown();
 
       }
}