CKTIS / Java
CountDownLatch — еднократно изчакване на сигнали
CountDownLatch координира нишки: await() изчаква повикванията на countDown() да намалят брояча до нула. Позволява изчакване на група операции и гарантира видимостта на предходни записи.
Версия: Java SE 21; repository runtime, production runtime not attested
Синтаксис
new CountDownLatch(count)
void await() throws InterruptedException
boolean await(long timeout, TimeUnit unit) throws InterruptedException
void countDown()CountDownLatch от java.util.concurrent позволява на нишките да изчакват фиксиран брой сигнали. Броячът представя повикванията на countDown(), а не непременно различни нишки. Блокировката е еднократна: не може да бъде нулирана.
CountDownLatch.countDown намалява положителен брояч, без да изчаква; при нула не прави нищо. CountDownLatch.await изчаква броячът да достигне нула. Вариантът await(timeout, unit) връща false, ако времето изтече, или true, когато бъде достигната нула. Прекъсването поражда InterruptedException и изчиства състоянието на прекъсване; предайте изключението нататък или го обработете съзнателно.
Записите преди сигналите, които намаляват брояча до нула, са във връзка happens-before с действията след успешно изчакване в друга нишка. Затова примерът прочита резултатите едва след done.await().
Сигнализирането в finally предотвратява пропускането на сигнала при изключение, но не означава, че задачата е успешна. Липсващите необходими сигнали могат да блокират безсрочно изчакване без времево ограничение; времевото ограничение не отменя работниците.
Примери
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]);
}
}Резултат
30
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.