CKTIS / Java
Phaser: registracija, čekanje na sljedeću fazu i odjava
Upotrijebite `Phaser` za sinkronizaciju zadataka u više faza, dodavanje sudionika tijekom faze i završetak rada barijere kad se posljednji sudionik odjavi.
Verzija: 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 u izdanju Java SE 21 višekratna je barijera s promjenjivim brojem sudionika. Phaser(int) počinje u fazi 0 bez nadređene barijere, sa zadanim brojem registriranih sudionika koji još nisu prijavili dolazak. Phaser() počinje bez sudionika. Negativan broj ili broj iznad ograničenja ove implementacije (65 535) izaziva IllegalArgumentException.
register() dodaje sudionika koji još mora prijaviti dolazak i vraća broj faze na koju se registracija odnosi. Ako je barijera završila s radom, poziv ništa ne mijenja i vraća negativnu vrijednost. Pokušaj registracije preko najvećeg dopuštenog broja sudionika izaziva IllegalStateException.
arriveAndAwaitAdvance() prijavljuje dolazak i čeka promjenu faze ili završetak rada barijere, zadržavajući registraciju. Sam prekid dretve ne završava čekanje. Za prekidivo čekanje ili vremensko ograničenje odvojite arrive() od odgovarajuće preopterećene varijante awaitAdvanceInterruptibly(...). arriveAndDeregister() prijavljuje dolazak i odjavljuje sudionika iz budućih faza bez čekanja na druge. Vraća fazu dolaska ili negativnu vrijednost ako je barijera već završila s radom.
Barijera vodi brojače, ne prati identitet dretvi. Prijavite jedan dolazak po sudioniku u svakoj fazi: izostanak prijave može blokirati ostale, a pogrešna prijava ne mora odmah izazvati iznimku. Kad se posljednji sudionik odjavi, zadani onAdvance(int, int) pri zatvaranju faze završava rad barijere. Stanje provjerite metodom isTerminated().
U fazi 0 main koristi mjesto iz konstruktora, registrira tri radne dretve prije njihova pokretanja i javlja vlastiti dolazak pozivom arrive(). Četvrta dretva registrira se u istoj fazi pa preko CompletableFuture oslobađa prve tri. main ne može nastaviti nakon awaitAdvance(...) dok ne stignu sve četiri radne dretve. U fazi 1 svih pet sudionika prijavljuje dolazak i čeka, a u fazi 2 svi prijavljuju dolazak i odjavljuju se.
Primjeri
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
Samo `main` ispisuje poruke. Nakon faze 0 i dalje je registrirano pet sudionika jer faza 1 ne može završiti bez dolaska `main`. Zadnji se redak ispisuje nakon povratka iz `join()` za sve četiri radne dretve.
Povezane lekcije
- Java · Lekcija 35 · Napredno · Verzija: 2