Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / Java

CountDownLatch — jednorazové čakanie na signály

CountDownLatch koordinuje vlákna: await() čaká, kým volania countDown() neznížia počítadlo na nulu. Umožňuje čakať na skupinu operácií a zaručuje viditeľnosť predchádzajúcich zápisov.

Verzia: 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 z java.util.concurrent umožňuje vláknam čakať na pevne stanovený počet signálov. Počítadlo predstavuje volania countDown(), nie nevyhnutne rôzne vlákna. Závora je jednorazová: nedá sa resetovať.

CountDownLatch.countDown zníži kladné počítadlo bez čakania; pri nule neurobí nič. CountDownLatch.await čaká, kým počítadlo dosiahne nulu. Variant await(timeout, unit) vráti false, ak uplynie časový limit, alebo true, keď sa dosiahne nula. Prerušenie vyvolá InterruptedException a vymaže stav prerušenia; výnimku odovzdajte ďalej alebo ju zámerne spracujte.

Zápisy pred signálmi, ktoré znížia počítadlo na nulu, sú vo vzťahu happens-before k akciám po úspešnom čakaní v inom vlákne. Preto príklad číta výsledky až po done.await().

Signalizácia v finally zabráni tomu, aby výnimka vynechala signál, neznamená však úspešné dokončenie úlohy. Chýbajúce potrebné signály môžu čakanie bez časového limitu zablokovať na neurčito; časový limit pracovníkov nezruší.

Príklady

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

Výsledok

30

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje