Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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

Zdroje