CountDownLatch的介紹和使用

　

CountDownLatch的介紹和使用

本文由arthinking發表於3年前 | Java基礎 | 評論數 5 |  被圍觀 19,761 views+

1、類介紹2、使用場景3、方法說明4、相關實例

1、類介紹

java.util.concurrent
類 CountDownLatch

java.lang.Object

java.util.concurrent.CountDownLatch

一個同步輔助類，在完成一組正在其他線程中執行的操作之前，它允許一個或多個線程一直等待。

用給定的計數 初始化 CountDownLatch。由於調用了 countDown() 方法，所以在當前計數到達零之前，await 方法會一直受阻塞。之後，會釋放所有等待的線程，await 的所有後續調用都將立即返回。這種現象只出現一次——計數無法被重置。如果需要重置計數，請考慮使用 CyclicBarrier。

2、使用場景

在一些應用場合中，需要等待某個條件達到要求後才能做後面的事情；同時當線程都完成後也會觸發事件，以便進行後面的操作。 這個時候就可以使用CountDownLatch。CountDownLatch最重要的方法是countDown()和await()，前者主要是倒數一次(計數減一)，後者是等待倒數到0，如果沒有到達0，就只有阻塞等待調用線程。

3、方法說明

countDown

public void countDown()

遞減鎖存器的計數，如果計數到達零，則釋放所有等待的線程。如果當前計數大於零，則將計數減少。如果新的計數爲零，出於線程調度目的，將重新啓用所有的等待線程。

如果當前計數等於零，則不發生任何操作。

await

public boolean await(long timeout,
                     TimeUnit unit)
              throws InterruptedException

使當前線程在鎖存器倒計數至零之前一直等待，除非線程被中斷或超出了指定的等待時間。如果當前計數爲零，則此方法立刻返回 true 值。

如果當前計數大於零，則出於線程調度目的，將禁用當前線程，且在發生以下三種情況之一前，該線程將一直處於休眠狀態：

• 由於調用 countDown() 方法，計數到達零；或者
• 其他某個線程中斷當前線程；或者
• 已超出指定的等待時間。

如果計數到達零，則該方法返回 true 值。

如果當前線程：

• 在進入此方法時已經設置了該線程的中斷狀態；或者
• 在等待時被中斷，

則拋出 InterruptedException，並且清除當前線程的已中斷狀態。如果超出了指定的等待時間，則返回值爲 false。如果該時間小於等於零，則此方法根本不會等待。

 

參數：

timeout - 要等待的最長時間

unit - timeout 參數的時間單位。

返回：

如果計數到達零，則返回 true；如果在計數到達零之前超過了等待時間，則返回 false

拋出：

InterruptedException - 如果當前線程在等待時被中斷

4、相關實例

// 一個CountDouwnLatch實例是不能重複使用的，也就是說它是一次性的，鎖一經被打開就不能再關閉使用了，如果想重複使用，請考慮使用CyclicBarrier。
public class CountDownLatchTest {

    // 模擬了100米賽跑，10名選手已經準備就緒，只等裁判一聲令下。當所有人都到達終點時，比賽結束。
    public static void main(String[] args) throws InterruptedException {

        // 開始的倒數鎖 
        final CountDownLatch begin = new CountDownLatch(1);  

        // 結束的倒數鎖 
        final CountDownLatch end = new CountDownLatch(10);  

        // 十名選手 
        final ExecutorService exec = Executors.newFixedThreadPool(10);  

        for (int index = 0; index < 10; index++) {
            final int NO = index + 1;  
            Runnable run = new Runnable() {
                public void run() {  
                    try {  
                        // 如果當前計數爲零，則此方法立即返回。
                        //準備。。。
                        begin.await();  
                        Thread.sleep((long) (Math.random() * 10000));  
                        System.out.println("No." + NO + " arrived");  
                    } catch (InterruptedException e) {  
                    } finally {  
                        // 每個選手到達終點時，end就減一
                        end.countDown();
                    }  
                }  
            };  
            exec.submit(run);
        }  
        System.out.println("Game Start");  
        // begin減一，開始遊戲，開跑。。。
        begin.countDown();  
        // 等待end變爲0，即所有選手到達終點
        end.await();  
        System.out.println("Game Over");  
        exec.shutdown();  
    }
}

本文鏈接：http://www.itzhai.com/the-introduction-and-use-of-a-countdownlatch.html