CKTIS / Java
Phaser: registracija, čakanje na naslednjo fazo in odjava
Z razredom `Phaser` uskladite opravila v več fazah, med fazo dodajte novega udeleženca in končajte delovanje pregrade, ko se odjavi še zadnji udeleženec.
Različica: Java SE 21
Sintaksa
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 je v Java SE 21 večkrat uporabna pregrada s spremenljivim številom udeležencev. Phaser(int) začne v fazi 0 brez nadrejene pregrade in z navedenim številom registriranih udeležencev, ki še niso sporočili prihoda. Phaser() začne brez udeležencev. Negativno število ali vrednost nad omejitvijo te implementacije (65 535) sproži IllegalArgumentException.
register() doda udeleženca, ki mora še sporočiti prihod, in vrne fazo, za katero velja registracija. Po koncu delovanja pregrade ne spremeni ničesar in vrne negativno vrednost. Poskus registracije prek največjega dovoljenega števila udeležencev sproži IllegalStateException.
arriveAndAwaitAdvance() sporoči prihod in počaka na prehod v naslednjo fazo ali konec delovanja pregrade, ne da bi odjavil udeleženca. Prekinitev niti sama ne konča čakanja. Za prekinljivo čakanje ali časovno omejitev uporabite arrive() in ločen klic ustrezne preobremenjene različice awaitAdvanceInterruptibly(...). arriveAndDeregister() sporoči prihod in odjavi udeleženca iz prihodnjih faz, ne da bi čakal na druge. Vrne fazo prihoda ali negativno vrednost, če je pregrada že končala delovanje.
Pregrada vodi števce in ne beleži identitete niti. Za vsakega udeleženca sporočite en prihod na fazo: manjkajoči prihod lahko ustavi druge, napačen prihod pa ne sproži nujno takojšnje izjeme. Ko se odjavi zadnji udeleženec, privzeti onAdvance(int, int) ob zaključku faze konča delovanje pregrade. Stanje lahko preverite z isTerminated().
V fazi 0 main uporabi mesto iz konstruktorja, registrira tri delovne niti pred njihovim zagonom in sporoči svoj prihod z arrive(). Četrta nit se registrira v isti fazi, nato prek CompletableFuture sprosti prve tri. main ne more nadaljevati po awaitAdvance(...), dokler ne prispejo vse štiri delovne niti. V fazi 1 vseh pet udeležencev sporoči prihod in počaka, v fazi 2 pa vsi sporočijo prihod in se odjavijo.
Primeri
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());
}
}Rezultat
Phase 0 complete: 5 registered Phase 1 complete Phase 2 complete: terminated = true
Izpisuje samo `main`. Po fazi 0 je še vedno registriranih pet udeležencev, saj se faza 1 ne more končati brez prihoda `main`. Zadnja vrstica se izpiše, ko se `join()` vrne za vse štiri delovne niti.
Povezane lekcije
- Java · Lekcija 35 · Napredna · Različica: 2