KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / Java

CountDownLatch — eenmalig wachten op signalen

CountDownLatch coördineert threads: await() wacht totdat aanroepen van countDown() de teller op nul zetten. Hiermee kan op een groep bewerkingen worden gewacht en worden eerdere schrijfacties zichtbaar.

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

Syntax

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

CountDownLatch uit java.util.concurrent laat threads wachten op een vast aantal signalen. De teller staat voor aanroepen van countDown(), niet noodzakelijk voor verschillende threads. De latch kan maar één keer worden gebruikt: resetten is niet mogelijk.

CountDownLatch.countDown verlaagt een positieve teller zonder te wachten; bij nul doet de methode niets. CountDownLatch.await wacht totdat de teller nul is. De variant await(timeout, unit) geeft false terug als de tijdslimiet verstrijkt, of true zodra nul is bereikt. Een onderbreking veroorzaakt InterruptedException en wist de interruptstatus; geef de uitzondering door of handel deze bewust af.

Schrijfacties vóór de signalen die de teller op nul zetten, staan in een happens-before-relatie met acties na succesvol wachten in een andere thread. Daarom leest het voorbeeld de resultaten pas na done.await().

Een signaal in finally voorkomt dat een uitzondering het signaal overslaat, maar betekent niet dat de taak is geslaagd. Ontbrekende vereiste signalen kunnen een wachtactie zonder tijdslimiet voor onbepaalde tijd blokkeren; een tijdslimiet annuleert de workers niet.

Voorbeelden

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

Resultaat

30

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen