CKTIS / Java
Phaser: rejestracja, oczekiwanie i wyrejestrowanie
Użyj `Phaser`, aby synchronizować zadania w kolejnych fazach, przyjąć nowego uczestnika w trakcie fazy i zakończyć działanie bariery po odejściu wszystkich uczestników.
Wersja: Java SE 21
Składnia
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 w Java SE 21 to wielokrotnego użytku bariera z dynamiczną liczbą uczestników. Konstruktor Phaser(int) tworzy barierę bez rodzica w fazie 0, z podaną liczbą uczestników już zarejestrowanych, którzy jeszcze nie zgłosili dotarcia. Phaser() zaczyna bez uczestników. Ujemna liczba lub wartość powyżej limitu tej implementacji (65 535) powoduje IllegalArgumentException.
register() dodaje jednego uczestnika, który musi jeszcze zgłosić dotarcie, i zwraca numer fazy objętej rejestracją. Po zakończeniu bariery nic nie zmienia i zwraca wartość ujemną. Próba przekroczenia limitu rejestracji powoduje IllegalStateException.
arriveAndAwaitAdvance() zalicza dotarcie i czeka na zmianę fazy albo zakończenie bariery, nie usuwając rejestracji. Samo przerwanie wątku nie kończy oczekiwania; limit czasu lub obsługa przerwania wymagają osobnego arrive() i odpowiedniego wariantu awaitAdvanceInterruptibly(...). arriveAndDeregister() zalicza dotarcie i usuwa uczestnika z przyszłych faz bez czekania na innych. Zwraca numer fazy zgłoszenia albo wartość ujemną, jeśli bariera była już zakończona.
Bariera śledzi liczniki, nie tożsamość wątków. Zgłaszaj dotarcie raz na uczestnika w każdej fazie: brak zgłoszenia może zatrzymać innych, a błędne zgłoszenie nie musi natychmiast wywołać wyjątku. Domyślne onAdvance(int, int) kończy działanie bariery przy zamykaniu fazy, gdy ostatni uczestnik się wyrejestruje. Stan można sprawdzić przez isTerminated().
W fazie 0 main zajmuje miejsce z konstruktora, rejestruje trzy wątki robocze przed ich uruchomieniem i zgłasza własne dotarcie przez arrive(). Czwarty wątek roboczy rejestruje się jeszcze w tej fazie, zanim zwolni pierwszą trójkę przez CompletableFuture. main nie przejdzie przez awaitAdvance(...), dopóki cała czwórka nie zgłosi dotarcia. W fazie 1 cała piątka zgłasza dotarcie i czeka, a w fazie 2 wszyscy się wyrejestrowują.
Przykłady
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());
}
}Wynik
Phase 0 complete: 5 registered Phase 1 complete Phase 2 complete: terminated = true
Tylko `main` wypisuje komunikaty. Po fazie 0 nadal jest pięciu uczestników, bo faza 1 nie może się skończyć bez dotarcia `main`. Ostatni komunikat pojawia się po `join()` wszystkich czterech wątków roboczych.
Powiązane lekcje
- Java · Lekcja 35 · Zaawansowany · Wersja: 2