CKTIS / Java
CountDownLatch — espera de un solo uso a señales
CountDownLatch coordina hilos: await() espera hasta que las llamadas a countDown() reduzcan el contador a cero. Permite esperar a un grupo de operaciones y garantiza la visibilidad de escrituras anteriores.
Versión: Java SE 21; repository runtime, production runtime not attested
Sintaxis
new CountDownLatch(count)
void await() throws InterruptedException
boolean await(long timeout, TimeUnit unit) throws InterruptedException
void countDown()CountDownLatch, de java.util.concurrent, permite que los hilos esperen un número fijo de señales. El contador representa llamadas a countDown(), no necesariamente hilos distintos. El latch es de un solo uso: no se puede reiniciar.
CountDownLatch.countDown decrementa un contador positivo sin esperar; si ya está en cero, no hace nada. CountDownLatch.await espera a que llegue a cero. La variante await(timeout, unit) devuelve false si vence el plazo o true cuando se alcanza cero. Una interrupción lanza InterruptedException y borra el estado de interrupción; propaga la excepción o gestiónala de forma deliberada.
Las escrituras anteriores a las señales que reducen el contador a cero mantienen una relación happens-before con las acciones posteriores a una espera satisfactoria en otro hilo. Por eso, el ejemplo lee los resultados solo después de done.await().
Señalizar en finally evita que una excepción omita la señal, pero no implica que la tarea haya tenido éxito. Si faltan señales necesarias, una espera sin límite de tiempo puede bloquearse indefinidamente; un tiempo límite no cancela los workers.
Ejemplos
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]);
}
}Resultado
30
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.