CKTIS / Java
CyclicBarrier : action de barrière et méthode await
Synchronisez un nombre fixe de threads entre deux phases, exécutez une action commune avant la reprise et distinguez les attentes avec et sans délai maximal.
Version : Java SE 21
Syntaxe
import java.util.concurrent.CyclicBarrier;
import java.util.concurrent.TimeUnit;
CyclicBarrier barrier = new CyclicBarrier(parties, barrierAction);
int arrivalIndex = barrier.await();
// Alternative for an arrival with a time limit:
int timedArrivalIndex = barrier.await(timeout, TimeUnit.SECONDS);Dans Java SE 21, java.util.concurrent.CyclicBarrier synchronise un nombre fixe de threads entre deux phases. Le constructeur CyclicBarrier(int,Runnable) prend le nombre de participants et une action facultative. Un nombre inférieur à 1 déclenche IllegalArgumentException. Passer null ou utiliser CyclicBarrier(int) revient à ne définir aucune action.
La méthode d’instance CyclicBarrier.await, sous sa forme sans argument await(), attend tous les participants sans limite de temps. Le dernier thread arrivé exécute l’action une fois par tour, avant que le moindre appel ne se termine normalement. Le résultat de type int est l’indice d’arrivée : parties - 1 pour le premier et 0 pour le dernier. Le bloc if (barrier.await() == 0) ne s’exécute qu’après la libération du groupe : il ne remplace pas une action qui doit se terminer avant que les autres threads avancent.
Le travail effectué avant await() précède l’action de barrière au sens de la relation happens-before. La même relation relie cette action au travail des autres threads après le retour normal de leur appel correspondant. Après un tour réussi, la même barrière est automatiquement prête pour le suivant, sans appel à reset().
await(long timeout, TimeUnit unit) limite l’attente. Si le délai expire, le thread appelant reçoit TimeoutException et la barrière passe à l’état rompu. Si await traite une interruption alors que le tour du thread est toujours en cours et que la barrière n’est pas rompue, la méthode lève InterruptedException, efface l’indicateur d’interruption du thread et rompt la barrière. Si, au contraire, le tour se termine normalement et que la barrière passe au suivant avant que le thread en attente ne traite l’interruption, await peut renvoyer l’indice d’arrivée avec l’indicateur d’interruption activé, rétabli si nécessaire. Une exception levée dans l’action remonte au dernier arrivé et rompt elle aussi la barrière. Les autres threads en attente reçoivent généralement BrokenBarrierException, tout comme les appels sur une barrière déjà rompue. reset() restaure l’état initial, mais fait échouer les attentes en cours avec BrokenBarrierException : il faut donc coordonner la reprise.
Exemples
import java.util.List;
import java.util.concurrent.Callable;
import java.util.concurrent.CyclicBarrier;
import java.util.concurrent.ExecutionException;
import java.util.concurrent.Executors;
public class BarrierPhases {
public static void main(String[] args) throws InterruptedException, ExecutionException {
int parties = 3;
var barrier = new CyclicBarrier(parties,
() -> System.out.println("4: Barrier action"));
Callable<Void> worker = () -> {
System.out.println("Phase 1");
barrier.await();
System.out.println("Phase 2");
return null;
};
try (var pool = Executors.newFixedThreadPool(parties)) {
for (var result : pool.invokeAll(List.of(worker, worker, worker))) {
result.get();
}
}
}
}Résultat
Phase 1 Phase 1 Phase 1 4: Barrier action Phase 2 Phase 2 Phase 2
Trois tâches utilisent trois threads du pool et franchissent la barrière une seule fois. `4: Barrier action` est la quatrième ligne affichée, pas un quatrième participant. Dans une même phase, les tâches affichent le même texte : leur ordre d’exécution ne change donc pas la sortie.
Leçons associées
- Java · Leçon 34 · Avancé · Version : 2