CKTIS / Java
Phaser: registrare, attendere il cambio di fase e annullare la registrazione
Usa `Phaser` per sincronizzare più attività in fasi successive, aggiungere un partecipante durante una fase e terminare la barriera quando esce l’ultimo partecipante.
Versione: Java SE 21
Sintassi
import java.util.concurrent.Phaser;
Phaser phaser = new Phaser(1); // Signature: Phaser(int parties)
int registrationPhase = phaser.register();
phaser.arriveAndAwaitAdvance();
int arrivalPhase = phaser.arriveAndDeregister();In Java SE 21, java.util.concurrent.Phaser è una barriera riutilizzabile con un numero variabile di partecipanti. Phaser(int) parte dalla fase 0, senza un Phaser padre, con il numero indicato di partecipanti già registrati e non ancora arrivati. Phaser() parte senza partecipanti. Un valore negativo o superiore al limite di questa implementazione, 65 535, causa IllegalArgumentException.
register() aggiunge un partecipante che deve ancora segnalare l’arrivo e restituisce la fase a cui si applica la registrazione. Dopo la terminazione non cambia nulla e restituisce un valore negativo. Tentare di superare il limite di partecipanti tramite la registrazione causa IllegalStateException.
arriveAndAwaitAdvance() segnala l’arrivo e attende il cambio di fase o la terminazione, mantenendo la registrazione. Una semplice interruzione non conclude l’attesa. Per un’attesa interrompibile o con un limite di tempo, separa arrive() dall’overload appropriato di awaitAdvanceInterruptibly(...). arriveAndDeregister() segnala l’arrivo e rimuove il partecipante dalle fasi successive, senza aspettare gli altri. Restituisce la fase di arrivo o un valore negativo se la barriera era già terminata.
La barriera tiene dei contatori, non traccia l’identità dei thread. Segnala un solo arrivo per partecipante e per fase: un arrivo mancante può bloccare gli altri e uno non valido non genera necessariamente un’eccezione immediata. Quando esce l’ultimo partecipante, l’implementazione predefinita di onAdvance(int, int) termina la barriera alla fine della fase. Usa isTerminated() per controllare lo stato.
Nella fase 0, main usa il posto riservato dal costruttore, registra tre thread di lavoro prima di avviarli e segnala il proprio arrivo con arrive(). Un quarto thread si registra nella stessa fase prima di sbloccare i primi tre tramite un CompletableFuture. main non può superare awaitAdvance(...) finché non arrivano tutti e quattro. Nella fase 1, tutti e cinque segnalano l’arrivo e attendono; nella fase 2, tutti segnalano l’arrivo e annullano la registrazione.
Esempi
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());
}
}Risultato
Phase 0 complete: 5 registered Phase 1 complete Phase 2 complete: terminated = true
Solo `main` stampa. Dopo la fase 0 ci sono ancora cinque partecipanti registrati, perché la fase 1 non può finire senza l’arrivo di `main`. L’ultima riga viene stampata dopo che `join()` è ritornato per tutti e quattro i thread di lavoro.
Lezioni correlate
- Java · Lezione 35 · Avanzato · Versione: 2