CKTIS / Java
CountDownLatch в Java: конструктор, await и countDown
Използвай еднократен брояч за подаване на стартов сигнал или за изчакване на определен брой сигнали. Научи двата варианта на await, правилата за прекъсване и гаранцията за видимост на записите.
Версия: Java SE 21
Синтаксис
Java SE 21 — java.util.concurrent.CountDownLatch
public CountDownLatch(int count)
public void await() throws InterruptedException
public boolean await(long timeout, TimeUnit unit) throws InterruptedException
public void countDown()В Java SE 21 java.util.concurrent.CountDownLatch служи за еднократна синхронизация. Конструкторът CountDownLatch(int) задава броя на сигналите, а не на нишките: една нишка може да съобщи за няколко събития. При 0 преградата е отворена отначало, а отрицателна стойност води до IllegalArgumentException. CountDownLatch.countDown намалява положителния брояч с едно, без да чака останалите сигнали. При достигане на нула всички чакащи нишки се освобождават, без да се определя редът, в който продължават. При нула следващите извиквания на countDown() нямат ефект. Броячът не може да се върне в начално състояние; за нов цикъл използвай нов обект.
CountDownLatch.await има два претоварени варианта. await() има тип на връщане void и при положителен брояч чака без ограничение във времето. await(long timeout, TimeUnit unit) връща true, ако броячът е или достигне нула, или false, ако срокът изтече преди това. Неположителен срок означава проверка без изчакване. И двата варианта хвърлят InterruptedException и изчистват флага за прекъсване, ако той е зададен при влизане или нишката бъде прекъсната по време на чакането. В противен случай при нула се връщат веднага.
Двойката CountDownLatch.await/countDown гарантира видимост на данните. Действията преди countDown(), което намалява брояча, са в отношение happens-before с действията на друга нишка след успешно връщане от await() или след резултат true от варианта със срок върху същия обект. Резултат false не дава тази гаранция. Преградата не осигурява взаимно изключване.
Използвай отделен брояч за всяко условие. start = 1 разрешава общия старт, а done = 3 събира три сигнала за приключване. За две групи задай immediateReady = 2 и deferredReady = 4. Всеки участник сигнализира веднъж, че е готов в своята група, а първата група не може да продължи, докато координаторът не отвори отделната преграда releaseImmediate = 1. Когато и двата брояча за готовност достигнат нула, без Thread.sleep знаеш, че от първата група са подадени поне два сигнала за готовност, а от втората поне четири. Това не доказва, че нишките вече са блокирани. При един сигнал на участник точно два и четири сигнала са гарантирани само ако независимо от броячите е определено, че първата група има двама участници, а втората — четирима. За координиране на заемането на ресурс използвай два брояча със стойност 1: първият потвърждава заемането, а вторият дава сигнал за освобождаване.
При липсващ сигнал нишката може да чака неограничено. Ако броиш приключилите опити, включително неуспешните, извиквай countDown() във finally и съобщавай грешките отделно. Нулата потвърждава получаването на нужните сигнали, а не успеха на работата.
Примери
import java.util.Arrays;
import java.util.concurrent.CountDownLatch;
import java.util.concurrent.TimeUnit;
public class LatchDemo {
public static void main(String[] args) throws InterruptedException {
int[] results = new int[3];
int[] input = new int[1];
CountDownLatch start = new CountDownLatch(1);
CountDownLatch done = new CountDownLatch(3);
for (int i = 0; i < results.length; i++) {
int slot = i;
new Thread(() -> {
try {
start.await();
results[slot] = input[0] + slot;
} catch (InterruptedException e) {
Thread.currentThread().interrupt();
} finally {
done.countDown();
}
}).start();
}
System.out.println("Start open: " + start.await(0, TimeUnit.SECONDS));
input[0] = 10;
start.countDown();
done.await();
System.out.println("Results: " + Arrays.toString(results));
done.countDown();
System.out.println("Done open: " + done.await(0, TimeUnit.SECONDS));
}
}Резултат
Start open: false Results: [10, 11, 12] Done open: true
Само `main` извежда текст. Първо проверява затворената преграда, после записва `10` и отваря `start`. Всяка работна нишка записва в собствена позиция в масива. След `done.await()` записите са видими за `main`; допълнителното `done.countDown()` не затваря преградата.
Свързани уроци
- Java · Урок 34 · Напреднало · Версия: 2
- Java · Урок 36 · Напреднало · Версия: 2
- Java · Урок 58 · Средно · Версия: 2