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

CKTIS / Java

CountDownLatch — jednorázové čekání na signály

CountDownLatch koordinuje vlákna: await() čeká, dokud volání countDown() nesníží počitadlo na nulu. Umožňuje čekat na skupinu operací a zajišťuje viditelnost dřívějších zápisů.

Verze: Java SE 21; repository runtime, production runtime not attested

Syntaxe

new CountDownLatch(count)
void await() throws InterruptedException
boolean await(long timeout, TimeUnit unit) throws InterruptedException
void countDown()

CountDownLatch z java.util.concurrent umožňuje vláknům čekat na pevně stanovený počet signálů. Počitadlo představuje volání countDown(), nikoli nutně různá vlákna. Závora je jednorázová: nelze ji resetovat.

CountDownLatch.countDown sníží kladné počitadlo, aniž by čekalo; při nule nic neudělá. CountDownLatch.await čeká, dokud počitadlo nedosáhne nuly. Varianta await(timeout, unit) vrátí false, pokud vyprší časový limit, nebo true, když je dosaženo nuly. Přerušení vyvolá InterruptedException a vymaže stav přerušení; výjimku předejte dál nebo ji vědomě zpracujte.

Zápisy před signály, které sníží počitadlo na nulu, jsou ve vztahu happens-before k akcím po úspěšném čekání v jiném vlákně. Proto příklad čte výsledky až po done.await().

Signalizace v finally zabrání tomu, aby výjimka vynechala signál, ale neznamená úspěšné dokončení úlohy. Chybějící požadované signály mohou čekání bez časového limitu zablokovat na neurčito; časový limit pracovní vlákna nezruší.

Příklady

import java.util.concurrent.CountDownLatch;

public class LatchDemo {
    public static void main(String[] args) throws InterruptedException {
        CountDownLatch done = new CountDownLatch(2);
        int[] results = new int[2];

        for (int i = 0; i < results.length; i++) {
            final int index = i;
            new Thread(() -> {
                try {
                    results[index] = (index + 1) * 10;
                } finally {
                    done.countDown();
                }
            }).start();
        }

        done.await();
        System.out.println(results[0] + results[1]);
    }
}

Výsledek

30

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje