Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

CountDownLatch w Javie: konstruktor, await i countDown

Użyj jednorazowego licznika do otwarcia bramki startowej lub oczekiwania na określoną liczbę sygnałów. Poznaj oba warianty await, obsługę przerwania i gwarancję widoczności danych.

Wersja: Java SE 21

Składnia

Java SE 21 — java.util.concurrent.CountDownLatch
public CountDownLatch(int count)
public void await() throws InterruptedException
public boolean await(long timeout, TimeUnit unit) throws InterruptedException
public void countDown()

W Java SE 21 klasa java.util.concurrent.CountDownLatch służy do jednorazowej synchronizacji. Konstruktor CountDownLatch(int) ustala liczbę sygnałów, a nie liczbę wątków: jeden wątek może zgłosić kilka zdarzeń. Wartość 0 od razu otwiera bramkę, a wartość ujemna powoduje IllegalArgumentException. Metoda CountDownLatch.countDown zmniejsza dodatni licznik o jeden i nie czeka na pozostałe sygnały. Przejście do zera zwalnia wszystkie oczekujące wątki, ale nie ustala kolejności ich wznowienia. Przy zerze kolejne countDown() nie mają skutku. Licznika nie można zresetować; do nowej rundy użyj nowej instancji.

CountDownLatch.await ma dwa przeciążenia. await() ma typ zwracany void i czeka bez limitu czasu, jeśli licznik jest dodatni. await(long timeout, TimeUnit unit) zwraca true, gdy licznik osiągnie zero lub już wynosi zero, albo false, gdy czas upłynie, zanim licznik spadnie do zera. Limit niedodatni oznacza sprawdzenie bez czekania. Oba przeciążenia zgłaszają InterruptedException i czyszczą znacznik przerwania, jeśli jest ustawiony przy wejściu lub wątek zostanie przerwany podczas oczekiwania. W przeciwnym razie przy zerze wracają od razu.

Para CountDownLatch.await/countDown zapewnia widoczność danych. Operacje wykonane przed countDown(), które zmniejsza licznik, są w relacji happens-before z operacjami innego wątku po pomyślnym powrocie z await() lub po wyniku true wariantu czasowego na tej samej instancji. Wynik false nie daje tej gwarancji. Bramka nie zapewnia wzajemnego wykluczania.

Używaj osobnego licznika dla każdego warunku. start = 1 otwiera wspólną bramkę startową, a done = 3 zbiera trzy sygnały zakończenia. Dla dwóch grup ustaw immediateReady = 2 i deferredReady = 4; każdy uczestnik raz zgłasza gotowość swojej grupy, a uczestnicy pierwszej grupy nie przechodzą dalej, dopóki koordynator nie otworzy osobnej bramki releaseImmediate = 1. Gdy oba liczniki gotowości osiągną zero, bez Thread.sleep wiadomo, że pierwsza grupa zgłosiła gotowość co najmniej dwa razy, a druga co najmniej cztery razy. Nie oznacza to, że wątki są już zablokowane. Przy jednym zgłoszeniu na uczestnika dokładnie dwa i cztery zgłoszenia są gwarantowane tylko wtedy, gdy niezależnie od liczników ustalono, że grupy liczą odpowiednio dwie i cztery osoby. Do koordynacji zajęcia zasobu użyj dwóch liczników po 1: pierwszy potwierdza zajęcie, drugi daje sygnał do zwolnienia.

Brak sygnału może zostawić wątek w oczekiwaniu bez końca. Jeśli liczysz zakończone próby, także nieudane, wywołaj countDown() w finally, a informację o błędzie przekaż osobno. Zero potwierdza otrzymanie wymaganych sygnałów, nie powodzenie pracy.

Przykłady

import java.util.Arrays;
import java.util.concurrent.CountDownLatch;
import java.util.concurrent.TimeUnit;

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

        for (int i = 0; i < results.length; i++) {
            int slot = i;
            new Thread(() -> {
                try {
                    start.await();
                    results[slot] = input[0] + slot;
                } catch (InterruptedException e) {
                    Thread.currentThread().interrupt();
                } finally {
                    done.countDown();
                }
            }).start();
        }

        System.out.println("Start open: " + start.await(0, TimeUnit.SECONDS));
        input[0] = 10;
        start.countDown();
        done.await();
        System.out.println("Results: " + Arrays.toString(results));
        done.countDown();
        System.out.println("Done open: " + done.await(0, TimeUnit.SECONDS));
    }
}

Wynik

Start open: false
Results: [10, 11, 12]
Done open: true

Tylko `main` wypisuje wynik. Najpierw sprawdza zamkniętą bramkę, potem zapisuje `10` i otwiera `start`. Każdy wątek zapisuje wynik pod własnym indeksem. Po `done.await()` zapisy są widoczne dla `main`; dodatkowe `done.countDown()` nie zamyka bramki.

Powiązane lekcje

  • Java · Lekcja 34 · Zaawansowany · Wersja: 2
  • Java · Lekcja 36 · Zaawansowany · Wersja: 2
  • Java · Lekcja 58 · Średniozaawansowany · Wersja: 2

Źródła