Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / Java

Phaser — synchroniser les étapes de travail

Phaser est une barrière de synchronisation réutilisable dont le nombre de participants peut varier. Elle permet aux tâches d’attendre la fin d’une étape et de se désinscrire lorsqu’elles ont terminé leur travail.

Version : Java SE 21; repository runtime, production runtime not attested

Syntaxe

Phaser phaser = new Phaser();
phaser.register();
phaser.arriveAndAwaitAdvance();
phaser.arriveAndDeregister();

Phaser coordonne des phases de travail successives. Phaser.register() ajoute un participant qui n’est pas encore arrivé. L’inscription modifie les compteurs, mais n’associe pas un participant à un thread particulier.

Phaser.arriveAndAwaitAdvance() signale l’arrivée et attend le changement de phase. Phaser.arriveAndDeregister() signale l’arrivée et retire le participant sans attendre. Par défaut, la suppression du dernier participant met fin à la barrière.

Dans l’exemple, new Phaser(1) tient compte du thread principal ; l’inscription supplémentaire a lieu avant le démarrage de worker. Deux phases séparent les calculs. La relation happens-before garantit que le résultat est visible après la deuxième barrière.

Une arrivée manquante peut bloquer les autres. arriveAndAwaitAdvance() ne cesse pas d’attendre en cas d’interruption ; pour une attente interruptible, utilisez awaitAdvanceInterruptibly(...) après arrive().

Exemples

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());
    }
}

Résultat

result=42
terminated=true

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources