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.