CKTIS / Java
Phaser : inscrire, attendre la phase suivante et désinscrire
Utilisez `Phaser` pour synchroniser des tâches sur plusieurs phases, ajouter un participant en cours de phase et terminer la barrière au départ du dernier participant.
Version : Java SE 21
Syntaxe
import java.util.concurrent.Phaser;
Phaser phaser = new Phaser(1); // Signature: Phaser(int parties)
int registrationPhase = phaser.register();
phaser.arriveAndAwaitAdvance();
int arrivalPhase = phaser.arriveAndDeregister();Dans Java SE 21, java.util.concurrent.Phaser est une barrière réutilisable dont le nombre de participants peut varier. Phaser(int) démarre en phase 0, sans barrière parente, avec le nombre indiqué de participants inscrits qui ne sont pas encore arrivés. Phaser() démarre sans participant. Un nombre négatif ou supérieur à la limite de cette implémentation, 65 535, déclenche IllegalArgumentException.
register() inscrit un participant dont l’arrivée reste à signaler et renvoie la phase à laquelle l’inscription s’applique. Si la barrière est déjà terminée, l’appel ne change rien et renvoie une valeur négative. Dépasser le nombre maximal de participants par une inscription déclenche IllegalStateException.
arriveAndAwaitAdvance() signale une arrivée et attend le changement de phase ou la terminaison, sans désinscrire le participant. Une interruption seule ne met pas fin à l’attente. Pour une attente interruptible ou limitée dans le temps, séparez arrive() de la surcharge appropriée de awaitAdvanceInterruptibly(...). arriveAndDeregister() signale l’arrivée et retire le participant des phases suivantes sans attendre les autres. La méthode renvoie la phase d’arrivée, ou une valeur négative si la barrière était déjà terminée.
La barrière tient des compteurs, sans identifier les threads. Signalez une seule arrivée par participant et par phase : une arrivée manquante peut bloquer les autres, et une arrivée invalide ne déclenche pas forcément une exception immédiate. Quand le dernier participant se désinscrit, l’implémentation par défaut de onAdvance(int, int) termine la barrière à la fin de la phase. isTerminated() permet de vérifier cet état.
En phase 0, main utilise la place réservée par le constructeur, inscrit trois threads de travail avant de les démarrer et signale sa propre arrivée avec arrive(). Un quatrième thread s’inscrit pendant cette même phase, puis libère les trois premiers via un CompletableFuture. main ne peut pas sortir de awaitAdvance(...) avant l’arrivée des quatre threads. En phase 1, les cinq participants signalent leur arrivée et attendent. En phase 2, ils signalent leur arrivée et se désinscrivent tous.
Exemples
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());
}
}Résultat
Phase 0 complete: 5 registered Phase 1 complete Phase 2 complete: terminated = true
Seul `main` affiche des messages. Après la phase 0, cinq participants sont encore inscrits, car la phase 1 ne peut pas se terminer sans l’arrivée de `main`. La dernière ligne est affichée après le retour de `join()` pour les quatre threads de travail.
Leçons associées
- Java · Leçon 35 · Avancé · Version : 2