Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

CyclicBarrier — cykliczna synchronizacja wątków

CyclicBarrier synchronizuje stałą liczbę uczestników na granicy kolejnych etapów. Wywołanie await() czeka na pozostałych; opcjonalna akcja scala wyniki przed rozpoczęciem następnego etapu.

Wersja: Java SE 21; repository runtime, production runtime not attested

Składnia

new CyclicBarrier(int parties)
new CyclicBarrier(int parties, Runnable barrierAction)
int await() throws InterruptedException, BrokenBarrierException
int await(long timeout, TimeUnit unit) throws InterruptedException, BrokenBarrierException, TimeoutException

CyclicBarrier z java.util.concurrent to wielokrotnie używany punkt synchronizacji. W przeciwieństwie do jednorazowego CountDownLatch obsługuje kolejne cykle. Konstruktor wymaga parties >= 1.

CyclicBarrier.await() czeka na wszystkich uczestników i zwraca indeks przybycia: ostatni otrzymuje 0. Ostatni wątek wykonuje opcjonalną akcję przed zwolnieniem pozostałych. Zapisy przed await() są widoczne dla akcji, a jej działania — po pomyślnym powrocie uczestników.

Przerwanie lub przekroczenie limitu czasu zrywa barierę: odpowiedni uczestnik otrzymuje InterruptedException lub TimeoutException, pozostali czekający — zwykle BrokenBarrierException. reset() również przerywa oczekiwanie; odzyskiwanie wymaga koordynacji. Zapewnij możliwość uruchomienia wszystkich uczestników, aby uniknąć bezterminowego oczekiwania.

Przykład używa dwóch wątków i dwóch cykli. Każdy wątek zapisuje własny element tablicy; akcja wypisuje sumę. Zakres: Java SE 21; środowisko produkcyjne nie zostało potwierdzone.

Przykłady

import java.util.concurrent.BrokenBarrierException;
import java.util.concurrent.CyclicBarrier;

public class BarrierDemo {
    public static void main(String[] args) throws InterruptedException {
        int[] values = new int[2];
        CyclicBarrier barrier = new CyclicBarrier(2,
                () -> System.out.println(values[0] + values[1]));

        Thread[] workers = new Thread[2];
        for (int i = 0; i < workers.length; i++) {
            final int index = i;
            workers[i] = new Thread(() -> {
                try {
                    for (int phase = 1; phase <= 2; phase++) {
                        values[index] = (index + 1) * phase;
                        barrier.await();
                    }
                } catch (InterruptedException e) {
                    Thread.currentThread().interrupt();
                } catch (BrokenBarrierException e) {
                    throw new IllegalStateException(e);
                }
            });
            workers[i].start();
        }
        for (Thread worker : workers) {
            worker.join();
        }
    }
}

Wynik

3
6

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła