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

CKTIS / Java

CountDownLatch — attente ponctuelle de signaux

CountDownLatch coordonne les threads : await() attend que les appels à countDown() ramènent le compteur à zéro. Il permet d’attendre un groupe d’opérations et garantit la visibilité des écritures antérieures.

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

Syntaxe

new CountDownLatch(count)
void await() throws InterruptedException
boolean await(long timeout, TimeUnit unit) throws InterruptedException
void countDown()

CountDownLatch, dans java.util.concurrent, permet aux threads d’attendre un nombre fixe de signaux. Le compteur représente les appels à countDown(), pas nécessairement des threads distincts. Le latch ne peut être utilisé qu’une fois : il ne peut pas être réinitialisé.

CountDownLatch.countDown décrémente un compteur positif sans attendre ; à zéro, il ne fait rien. CountDownLatch.await attend que le compteur atteigne zéro. La variante await(timeout, unit) renvoie false en cas d’expiration du délai ou true lorsque le compteur atteint zéro. Une interruption déclenche InterruptedException et efface l’état d’interruption ; propagez l’exception ou gérez-la de manière délibérée.

Les écritures précédant les signaux qui ramènent le compteur à zéro sont en relation happens-before avec les actions effectuées après une attente réussie dans un autre thread. C’est pourquoi l’exemple ne lit les résultats qu’après done.await().

Le signalement dans finally évite qu’une exception empêche l’envoi du signal, mais ne signifie pas que la tâche a réussi. Si des signaux requis manquent, une attente sans délai peut rester bloquée indéfiniment ; un délai d’attente n’annule pas les workers.

Exemples

import java.util.concurrent.CountDownLatch;

public class LatchDemo {
    public static void main(String[] args) throws InterruptedException {
        CountDownLatch done = new CountDownLatch(2);
        int[] results = new int[2];

        for (int i = 0; i < results.length; i++) {
            final int index = i;
            new Thread(() -> {
                try {
                    results[index] = (index + 1) * 10;
                } finally {
                    done.countDown();
                }
            }).start();
        }

        done.await();
        System.out.println(results[0] + results[1]);
    }
}

Résultat

30

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