CKTIS / Java
CountDownLatch — jednokratno čekanje na signale
CountDownLatch koordinira dretve: await() čeka dok pozivi countDown() ne smanje brojač na nulu. Omogućuje čekanje na skupinu operacija i jamči vidljivost ranijih zapisa.
Verzija: Java SE 21; repository runtime, production runtime not attested
Sintaksa
new CountDownLatch(count)
void await() throws InterruptedException
boolean await(long timeout, TimeUnit unit) throws InterruptedException
void countDown()CountDownLatch iz java.util.concurrent omogućuje dretvama čekanje na fiksan broj signala. Brojač predstavlja pozive countDown(), a ne nužno različite dretve. Brava je jednokratna: ne može se ponovno postaviti.
CountDownLatch.countDown smanjuje pozitivan brojač bez čekanja; na nuli ne radi ništa. CountDownLatch.await čeka dok brojač ne dosegne nulu. Varijanta await(timeout, unit) vraća false ako istekne vremensko ograničenje ili true kada se dosegne nula. Prekid uzrokuje InterruptedException i briše stanje prekida; proslijedite iznimku ili je namjerno obradite.
Zapisi prije signala koji smanjuju brojač na nulu u odnosu su happens-before s radnjama nakon uspješnog čekanja u drugoj dretvi. Zato primjer čita rezultate tek nakon done.await().
Signaliziranje u finally sprječava da iznimka izostavi signal, ali ne znači da je zadatak uspio. Nedostatak potrebnih signala može neograničeno blokirati čekanje bez vremenskog ograničenja; vremensko ograničenje ne otkazuje radne dretve.
Primjeri
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]);
}
}Rezultat
30
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.