CKTIS / Java
CountDownLatch v Javě: konstruktor, await a countDown
Použij jednorázové počítadlo ke spuštění práce nebo k čekání na pevný počet signálů. Nauč se rozlišovat obě varianty await, obsloužit přerušení a využít záruku viditelnosti zápisů.
Verze: Java SE 21
Syntaxe
Java SE 21 — java.util.concurrent.CountDownLatch
public CountDownLatch(int count)
public void await() throws InterruptedException
public boolean await(long timeout, TimeUnit unit) throws InterruptedException
public void countDown()V Java SE 21 slouží java.util.concurrent.CountDownLatch k jednorázové synchronizaci. Konstruktor CountDownLatch(int) nastaví počet signálů, nikoli počet vláken: jedno vlákno může ohlásit více událostí. Při hodnotě 0 je brána hned otevřená; záporná hodnota vyvolá IllegalArgumentException. CountDownLatch.countDown sníží kladné počítadlo o jedna a nečeká na ostatní signály. Přechod na nulu uvolní všechna čekající vlákna, ale neurčí pořadí jejich pokračování. Při nule další volání countDown() nic nemění. Počítadlo nelze znovu nastavit; pro další kolo použij novou instanci.
CountDownLatch.await má dvě přetížené varianty. await() má návratový typ void a při kladném počítadle čeká bez časového limitu. await(long timeout, TimeUnit unit) vrátí true, pokud je nebo bude počítadlo nulové dřív, než vyprší limit; pokud limit vyprší jako první, vrátí false. Nulový nebo záporný limit znamená kontrolu bez čekání. Obě varianty vyhodí InterruptedException a vynulují příznak přerušení, pokud byl nastaven při vstupu nebo bylo vlákno během čekání přerušeno. Jinak se při nule vrátí ihned.
Dvojice CountDownLatch.await/countDown zaručuje viditelnost dat. Akce před countDown(), které sníží počítadlo, jsou ve vztahu happens-before k akcím jiného vlákna po úspěšném návratu z await() nebo po výsledku true z časované varianty na téže instanci. Výsledek false tuto záruku neposkytuje. Brána nezajišťuje vzájemné vyloučení.
Pro každou podmínku použij samostatné počítadlo. start = 1 otevře společnou startovní bránu; done = 3 shromáždí tři signály dokončení. Pro dvě skupiny nastav immediateReady = 2 a deferredReady = 4. Každý účastník jednou ohlásí připravenost ve své skupině a první skupina nepokračuje, dokud koordinátor neotevře samostatnou bránu releaseImmediate = 1. Když obě počítadla připravenosti dosáhnou nuly, víš i bez Thread.sleep, že z první skupiny přišla nejméně dvě hlášení a z druhé nejméně čtyři, ne však to, že už jsou vlákna zablokovaná. Při jednom hlášení na účastníka máš zaručena přesně dvě a čtyři hlášení jen tehdy, pokud jsou nezávisle na počítadlech velikosti skupin pevně stanoveny na dva a čtyři účastníky. Pro koordinaci držení prostředku použij dvě počítadla s hodnotou 1: první potvrdí získání, druhé dá pokyn k uvolnění.
Chybějící signál může nechat vlákno čekat neomezeně dlouho. Pokud počítáš ukončené pokusy včetně neúspěšných, volej countDown() v finally a chyby hlaste zvlášť. Nula potvrzuje přijetí požadovaných signálů, nikoli úspěch práce.
Příklady
import java.util.Arrays;
import java.util.concurrent.CountDownLatch;
import java.util.concurrent.TimeUnit;
public class LatchDemo {
public static void main(String[] args) throws InterruptedException {
int[] results = new int[3];
int[] input = new int[1];
CountDownLatch start = new CountDownLatch(1);
CountDownLatch done = new CountDownLatch(3);
for (int i = 0; i < results.length; i++) {
int slot = i;
new Thread(() -> {
try {
start.await();
results[slot] = input[0] + slot;
} catch (InterruptedException e) {
Thread.currentThread().interrupt();
} finally {
done.countDown();
}
}).start();
}
System.out.println("Start open: " + start.await(0, TimeUnit.SECONDS));
input[0] = 10;
start.countDown();
done.await();
System.out.println("Results: " + Arrays.toString(results));
done.countDown();
System.out.println("Done open: " + done.await(0, TimeUnit.SECONDS));
}
}Výsledek
Start open: false Results: [10, 11, 12] Done open: true
Vypisuje pouze `main`. Nejprve zkontroluje zavřenou bránu, pak zapíše `10` a otevře `start`. Každé pracovní vlákno zapisuje do vlastní pozice v poli. Po `done.await()` jsou zápisy pro `main` viditelné; dodatečné `done.countDown()` bránu nezavře.
Související lekce
- Java · Lekce 34 · Pokročilá · Verze: 2
- Java · Lekce 36 · Pokročilá · Verze: 2
- Java · Lekce 58 · Středně pokročilá · Verze: 2