CKTIS / Java
CyclicBarrier — zyklische Thread-Synchronisierung
CyclicBarrier synchronisiert eine feste Anzahl von Teilnehmenden an aufeinanderfolgenden Phasengrenzen. Der Aufruf await() wartet auf die anderen; eine optionale Aktion führt Ergebnisse zusammen, bevor die nächste Phase beginnt.
Version: Java SE 21; repository runtime, production runtime not attested
Syntax
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 aus java.util.concurrent ist ein wiederverwendbarer Synchronisationspunkt. Anders als das einmalig verwendbare CountDownLatch unterstützt sie aufeinanderfolgende Zyklen. Ihr Konstruktor erfordert parties >= 1.
CyclicBarrier.await() wartet auf alle Teilnehmenden und gibt einen Ankunftsindex zurück: Der zuletzt eintreffende erhält 0. Der letzte Thread führt die optionale Aktion aus, bevor die anderen freigegeben werden. Schreibvorgänge vor await() sind für die Aktion sichtbar; deren Aktionen sind sichtbar, nachdem die Teilnehmenden erfolgreich zurückgekehrt sind.
Eine Unterbrechung oder eine Zeitüberschreitung löst die Barriere auf: Der betroffene Teilnehmende erhält InterruptedException oder TimeoutException, während andere wartende Teilnehmende normalerweise BrokenBarrierException erhalten. Auch reset() unterbricht das Warten; die Wiederherstellung erfordert Koordination. Stelle sicher, dass alle Teilnehmenden ausgeführt werden können, um unbegrenztes Warten zu vermeiden.
Das Beispiel verwendet zwei Threads und zwei Zyklen. Jeder Thread schreibt in sein eigenes Array-Element; die Aktion gibt die Summe aus. Geltungsbereich: Java SE 21; die Produktionslaufzeitumgebung wurde nicht bestätigt.
Beispiele
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();
}
}
}Ergebnis
3 6
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.