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, TimeoutExceptionCyclicBarrier 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.