Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła