CKTIS / Java
CountDownLatch — einmaliges Warten auf Signale
CountDownLatch koordiniert Threads: await() wartet, bis Aufrufe von countDown() den Zähler auf null senken. Damit lässt sich auf eine Gruppe von Vorgängen warten; außerdem werden frühere Schreibvorgänge sichtbar.
Version: 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 aus java.util.concurrent lässt Threads auf eine festgelegte Anzahl von Signalen warten. Der Zähler steht für Aufrufe von countDown(), nicht unbedingt für verschiedene Threads. Das Latch kann nur einmal verwendet werden: Es lässt sich nicht zurücksetzen.
CountDownLatch.countDown verringert einen positiven Zähler, ohne zu warten; bei null hat der Aufruf keine Wirkung. CountDownLatch.await wartet, bis der Zähler null ist. Die Variante await(timeout, unit) gibt bei Zeitüberschreitung false und beim Erreichen von null true zurück. Eine Unterbrechung löst InterruptedException aus und löscht den Unterbrechungsstatus; geben Sie die Ausnahme weiter oder behandeln Sie sie bewusst.
Schreibvorgänge vor den Signalen, die den Zähler auf null bringen, stehen in einer happens-before-Beziehung zu Aktionen nach dem erfolgreichen Warten in einem anderen Thread. Deshalb liest das Beispiel die Ergebnisse erst nach done.await().
Die Signalisierung in finally verhindert, dass eine Ausnahme das Signal überspringt, bedeutet aber nicht, dass die Aufgabe erfolgreich war. Fehlen erforderliche Signale, kann ein Warten ohne Zeitlimit unbegrenzt blockieren; ein Zeitlimit bricht die Worker nicht ab.
Beispiele
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]);
}
}Ergebnis
30
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.