CKTIS / Java
Phaser — synchronizacja etapów pracy
Phaser to wielokrotna bariera synchronizacyjna ze zmienną liczbą uczestników. Pozwala czekać na zakończenie etapu oraz wyrejestrowywać zadania kończące pracę.
Wersja: Java SE 21; repository runtime, production runtime not attested
Składnia
Phaser phaser = new Phaser();
phaser.register();
phaser.arriveAndAwaitAdvance();
phaser.arriveAndDeregister();Phaser koordynuje kolejne fazy pracy. Phaser.register() dodaje uczestnika, który jeszcze nie zgłosił przybycia. Rejestracja zmienia liczniki, ale nie przypisuje uczestnika do konkretnego wątku.
Phaser.arriveAndAwaitAdvance() zgłasza przybycie i czeka na zmianę fazy. Phaser.arriveAndDeregister() zgłasza przybycie i usuwa uczestnika bez oczekiwania. Domyślnie usunięcie ostatniego uczestnika kończy działanie bariery.
W przykładzie new Phaser(1) uwzględnia wątek główny; dodatkowa rejestracja następuje przed uruchomieniem worker. Dwie fazy oddzielają obliczenia. Relacja happens-before zapewnia widoczność wyniku po drugiej barierze.
Pominięte zgłoszenie przybycia może zablokować pozostałych. arriveAndAwaitAdvance() nie kończy oczekiwania wskutek przerwania; do oczekiwania przerywalnego służy awaitAdvanceInterruptibly(...) po arrive().
Przykłady
import java.util.concurrent.Phaser;
public class PhaserExample {
public static void main(String[] args) throws InterruptedException {
Phaser phaser = new Phaser(1);
int[] result = {0};
phaser.register();
Thread worker = new Thread(() -> {
result[0] = 21;
phaser.arriveAndAwaitAdvance();
result[0] *= 2;
phaser.arriveAndDeregister();
});
worker.start();
phaser.arriveAndAwaitAdvance();
phaser.arriveAndAwaitAdvance();
System.out.println("result=" + result[0]);
phaser.arriveAndDeregister();
worker.join();
System.out.println("terminated=" + phaser.isTerminated());
}
}Wynik
result=42 terminated=true
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.