CKTIS / Java
CountDownLatch — jednorazowe oczekiwanie na sygnały
CountDownLatch koordynuje wątki: await() czeka, aż wywołania countDown() sprowadzą licznik do zera. Nadaje się do oczekiwania na grupę operacji i zapewnia widoczność wcześniejszych zapisów.
Wersja: Java SE 21; repository runtime, production runtime not attested
Składnia
new CountDownLatch(count)
void await() throws InterruptedException
boolean await(long timeout, TimeUnit unit) throws InterruptedException
void countDown()CountDownLatch z java.util.concurrent pozwala wątkom czekać na określoną liczbę sygnałów. Licznik oznacza wywołania countDown(), niekoniecznie różne wątki. Zatrzask jest jednorazowy: nie można go zresetować.
CountDownLatch.countDown zmniejsza dodatni licznik bez oczekiwania; przy zerze nic nie robi. CountDownLatch.await czeka na zero. Wariant await(timeout, unit) zwraca false po upływie limitu albo true po osiągnięciu zera. Przerwanie powoduje InterruptedException i wyczyszczenie statusu przerwania; wyjątek należy przekazać dalej lub świadomie obsłużyć.
Zapisy poprzedzające sygnały prowadzące do zera są w relacji happens-before z działaniami po pomyślnym oczekiwaniu w innym wątku. Dlatego przykład odczytuje wyniki dopiero po done.await().
Sygnalizacja w finally zapobiega pominięciu jej przy wyjątku, lecz nie oznacza sukcesu zadania. Brak wymaganych sygnałów może zablokować oczekiwanie bezterminowo; limit czasu nie anuluje pracowników.
Przykłady
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]);
}
}Wynik
30
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.