CKTIS / Java
Phaser — synchronizace pracovních etap
Phaser je opakovaně použitelná synchronizační bariéra s proměnným počtem účastníků. Úlohy díky ní mohou čekat na dokončení etapy a po skončení práce se odhlásit.
Verze: Java SE 21; repository runtime, production runtime not attested
Syntaxe
Phaser phaser = new Phaser();
phaser.register();
phaser.arriveAndAwaitAdvance();
phaser.arriveAndDeregister();Phaser koordinuje po sobě jdoucí pracovní fáze. Phaser.register() přidá účastníka, který ještě nedorazil. Registrace mění počitadla, ale nepřiřazuje účastníka ke konkrétnímu vláknu.
Phaser.arriveAndAwaitAdvance() oznámí příchod a čeká na změnu fáze. Phaser.arriveAndDeregister() oznámí příchod a odstraní účastníka bez čekání. Ve výchozím nastavení odstranění posledního účastníka bariéru ukončí.
V příkladu new Phaser(1) počítá s hlavním vláknem; další registrace proběhne před spuštěním worker. Dvě fáze oddělují výpočty. Vztah happens-before zajišťuje viditelnost výsledku po druhé bariéře.
Chybějící příchod může ostatní zablokovat. arriveAndAwaitAdvance() nepřestane čekat kvůli přerušení; pro přerušitelné čekání použijte po arrive() metodu awaitAdvanceInterruptibly(...).
Příklady
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());
}
}Výsledek
result=42 terminated=true
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.