WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Java

CyclicBarrier: Barriereaktion und await

Synchronisiere eine feste Anzahl von Threads zwischen Phasen und führe vor dem Weiterlaufen eine gemeinsame Aktion aus. Lerne den Unterschied zwischen Warten mit und ohne Zeitlimit.

Version: Java SE 21

Syntax

import java.util.concurrent.CyclicBarrier;
import java.util.concurrent.TimeUnit;

CyclicBarrier barrier = new CyclicBarrier(parties, barrierAction);
int arrivalIndex = barrier.await();
// Alternative for an arrival with a time limit:
int timedArrivalIndex = barrier.await(timeout, TimeUnit.SECONDS);

In Java SE 21 synchronisiert java.util.concurrent.CyclicBarrier eine feste Anzahl von Threads an einer Phasengrenze. CyclicBarrier(int,Runnable) erwartet die Teilnehmerzahl und eine optionale Aktion. Eine Zahl unter 1 führt zu IllegalArgumentException. Mit null oder dem Konstruktor CyclicBarrier(int) gibt es keine Aktion.

Die parameterlose Variante await() der Instanzmethode CyclicBarrier.await wartet ohne Zeitlimit auf alle Teilnehmer. Der zuletzt eintreffende Thread führt die Aktion einmal pro Runde aus, bevor irgendein Aufruf erfolgreich zurückkehrt. Das int-Ergebnis ist der Ankunftsindex: parties - 1 für den ersten und 0 für den letzten Thread. Ein Zweig mit if (barrier.await() == 0) läuft erst nach Freigabe der Gruppe und ersetzt daher keine Aktion, die abgeschlossen sein muss, bevor die anderen Threads fortfahren.

Arbeit vor await() steht in einer happens-before-Beziehung zur Barriereaktion. Diese wiederum steht in dieser Beziehung zur Arbeit anderer Threads nach der entsprechenden erfolgreichen Rückkehr. Nach einer erfolgreichen Runde ist dieselbe Barriere automatisch für die nächste bereit; reset() ist nicht nötig.

await(long timeout, TimeUnit unit) begrenzt die Wartezeit. Läuft sie ab, erhält der aufrufende Thread eine TimeoutException, und die Barriere gilt als defekt. Verarbeitet await eine Unterbrechung, solange die Runde des Threads noch läuft und die Barriere nicht defekt ist, löst die Methode InterruptedException aus, löscht den Unterbrechungsstatus des Threads und versetzt die Barriere in den Fehlerzustand. Endet die Runde dagegen erfolgreich und wechselt die Barriere zur nächsten Runde, bevor der wartende Thread die Unterbrechung verarbeitet, kann await den Ankunftsindex mit gesetztem Unterbrechungsstatus zurückgeben. Der Status wird bei Bedarf wiederhergestellt. Eine Ausnahme aus der Aktion erreicht den zuletzt eingetroffenen Thread und hat dieselbe Wirkung auf die Barriere. Andere wartende Threads erhalten in der Regel BrokenBarrierException, ebenso Aufrufe an einer bereits defekten Barriere. reset() stellt den Anfangszustand wieder her, beendet aber laufende Wartevorgänge mit BrokenBarrierException. Die Wiederherstellung muss daher koordiniert werden.

Beispiele

import java.util.List;
import java.util.concurrent.Callable;
import java.util.concurrent.CyclicBarrier;
import java.util.concurrent.ExecutionException;
import java.util.concurrent.Executors;

public class BarrierPhases {
    public static void main(String[] args) throws InterruptedException, ExecutionException {
        int parties = 3;
        var barrier = new CyclicBarrier(parties,
                () -> System.out.println("4: Barrier action"));

        Callable<Void> worker = () -> {
            System.out.println("Phase 1");
            barrier.await();
            System.out.println("Phase 2");
            return null;
        };

        try (var pool = Executors.newFixedThreadPool(parties)) {
            for (var result : pool.invokeAll(List.of(worker, worker, worker))) {
                result.get();
            }
        }
    }
}

Ergebnis

Phase 1
Phase 1
Phase 1
4: Barrier action
Phase 2
Phase 2
Phase 2

Drei Aufgaben laufen auf drei Pool-Threads und passieren die Barriere nur einmal. `4: Barrier action` ist die vierte Ausgabezeile, kein vierter Teilnehmer. Innerhalb einer Phase geben alle Aufgaben denselben Text aus; die Thread-Reihenfolge ändert die Ausgabe daher nicht.

Zugehörige Lektionen

  • Java · Lektion 34 · Fortgeschritten · Version: 2

Quellen