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.