CKTIS / Java
CyclicBarrier — cyklická synchronizace vláken
CyclicBarrier synchronizuje pevný počet účastníků na hranicích po sobě jdoucích fází. Volání await() čeká na ostatní; volitelná akce spojí výsledky před začátkem další fáze.
Verze: Java SE 21; repository runtime, production runtime not attested
Syntaxe
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 je opakovaně použitelný synchronizační bod. Na rozdíl od jednorázového CountDownLatch podporuje po sobě jdoucí cykly. Její konstruktor vyžaduje parties >= 1.
CyclicBarrier.await() čeká na všechny účastníky a vrací index příchodu: poslední účastník obdrží 0. Poslední vlákno provede volitelnou akci před uvolněním ostatních. Zápisy před await() jsou viditelné pro tuto akci a její operace jsou viditelné poté, co se účastníci úspěšně vrátí.
Přerušení nebo vypršení časového limitu bariéru přeruší: dotčený účastník obdrží InterruptedException nebo TimeoutException, zatímco ostatní čekající účastníci obvykle obdrží BrokenBarrierException. Také reset() přeruší čekání; obnovení vyžaduje koordinaci. Zajistěte, aby se mohli spustit všichni účastníci, a předejděte tak neomezenému čekání.
Příklad používá dvě vlákna a dva cykly. Každé vlákno zapisuje do vlastního prvku pole; akce vypíše součet. Rozsah: Java SE 21; produkční běhové prostředí nebylo potvrzeno.
Příklady
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();
}
}
}Výsledek
3 6
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.