CKTIS / Java
Phaser: registrieren, auf den Phasenwechsel warten und abmelden
Mit `Phaser` lassen sich Aufgaben über mehrere Phasen synchronisieren, weitere Teilnehmer in einer laufenden Phase aufnehmen und die Barriere beim Abmelden des letzten Teilnehmers beenden.
Version: Java SE 21
Syntax
import java.util.concurrent.Phaser;
Phaser phaser = new Phaser(1); // Signature: Phaser(int parties)
int registrationPhase = phaser.register();
phaser.arriveAndAwaitAdvance();
int arrivalPhase = phaser.arriveAndDeregister();java.util.concurrent.Phaser ist in Java SE 21 eine wiederverwendbare Barriere mit veränderlicher Teilnehmerzahl. Phaser(int) startet ohne übergeordnete Barriere in Phase 0 mit der angegebenen Zahl registrierter Teilnehmer, deren Ankunft noch aussteht. Phaser() startet ohne Teilnehmer. Eine negative Zahl oder ein Wert über der Implementierungsgrenze von 65.535 löst IllegalArgumentException aus.
register() fügt einen Teilnehmer hinzu, dessen Ankunft noch aussteht, und gibt die Phase zurück, für die die Registrierung gilt. Nach der Beendigung ändert der Aufruf nichts und gibt einen negativen Wert zurück. Eine Registrierung über die Teilnehmergrenze hinaus löst IllegalStateException aus.
arriveAndAwaitAdvance() meldet die Ankunft und wartet auf den Phasenwechsel oder die Beendigung der Barriere. Der Teilnehmer bleibt registriert. Eine Unterbrechung allein beendet das Warten nicht. Für unterbrechbares Warten oder ein Zeitlimit kombiniert man arrive() mit der passenden Überladung von awaitAdvanceInterruptibly(...). arriveAndDeregister() meldet die Ankunft und entfernt den Teilnehmer aus späteren Phasen, ohne auf andere zu warten. Die Methode gibt die Ankunftsphase zurück oder einen negativen Wert, wenn die Barriere bereits beendet war.
Die Barriere führt Zähler, keine Thread-Identitäten. Melde pro Teilnehmer und Phase genau eine Ankunft: Eine fehlende Meldung kann andere aufhalten, und eine fehlerhafte Meldung muss nicht sofort eine Ausnahme auslösen. Wenn sich der letzte Teilnehmer abmeldet, beendet das standardmäßige onAdvance(int, int) die Barriere am Phasenende. Der Zustand ist mit isTerminated() prüfbar.
In Phase 0 nutzt main den Platz aus dem Konstruktor, registriert drei Worker vor ihrem Start und meldet die eigene Ankunft mit arrive(). Ein vierter Worker registriert sich noch in derselben Phase und gibt erst dann die ersten drei über ein CompletableFuture frei. main kann awaitAdvance(...) erst nach Ankunft aller vier Worker verlassen. In Phase 1 melden sich alle fünf an der Barriere und warten; in Phase 2 melden sie ihre Ankunft und melden sich ab.
Beispiele
import java.util.concurrent.CompletableFuture;
import java.util.concurrent.Phaser;
public class PhaserDemo {
private static void runWorker(Phaser phaser) {
phaser.arriveAndAwaitAdvance(); // Phase 0
phaser.arriveAndAwaitAdvance(); // Phase 1
phaser.arriveAndDeregister(); // Phase 2
}
public static void main(String[] args) throws InterruptedException {
Phaser phaser = new Phaser(1);
CompletableFuture<Void> lateWorkerRegistered = new CompletableFuture<>();
Thread[] workers = new Thread[4];
for (int i = 0; i < 3; i++) {
phaser.register();
workers[i] = new Thread(() -> {
lateWorkerRegistered.join();
runWorker(phaser);
});
workers[i].start();
}
int phaseZero = phaser.arrive();
workers[3] = new Thread(() -> {
phaser.register();
lateWorkerRegistered.complete(null);
runWorker(phaser);
});
workers[3].start();
phaser.awaitAdvance(phaseZero);
System.out.println("Phase 0 complete: " + phaser.getRegisteredParties() + " registered");
phaser.arriveAndAwaitAdvance();
System.out.println("Phase 1 complete");
phaser.arriveAndDeregister();
for (Thread worker : workers) {
worker.join();
}
System.out.println("Phase 2 complete: terminated = " + phaser.isTerminated());
}
}Ergebnis
Phase 0 complete: 5 registered Phase 1 complete Phase 2 complete: terminated = true
Nur `main` gibt Text aus. Nach Phase 0 sind noch fünf Teilnehmer registriert, da Phase 1 nicht ohne die Ankunft von `main` enden kann. Die letzte Zeile erscheint, nachdem `join()` für alle vier Worker zurückgekehrt ist.
Zugehörige Lektionen
- Java · Lektion 35 · Fortgeschritten · Version: 2