CKTIS / Java
CountDownLatch en Java: constructor, await y countDown
Usa un contador de un solo uso para dar la salida o esperar un número fijo de señales. Aprende las dos sobrecargas de await, qué ocurre al interrumpir un hilo y cuándo son visibles las escrituras.
Versión: Java SE 21
Sintaxis
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()En Java SE 21, java.util.concurrent.CountDownLatch es un mecanismo de sincronización de un solo uso. El constructor CountDownLatch(int) fija el número de señales, no el de hilos: un hilo puede notificar varios eventos. Con 0, la compuerta empieza abierta; un valor negativo provoca IllegalArgumentException. CountDownLatch.countDown resta uno a un contador positivo sin esperar otras señales. El paso a cero libera a todos los hilos en espera sin determinar el orden en que se reanudan. A cero, las llamadas posteriores a countDown() no tienen efecto. El contador no se puede reiniciar; usa una instancia nueva para otra ronda.
CountDownLatch.await tiene dos sobrecargas. await() devuelve void y, si el contador es positivo, espera sin límite de tiempo. await(long timeout, TimeUnit unit) devuelve true si el contador está o llega a cero, o false si el plazo vence antes. Un tiempo de espera igual o inferior a cero comprueba el estado sin esperar. Ambas sobrecargas lanzan InterruptedException y limpian el estado de interrupción si ya está activado al entrar o si el hilo es interrumpido mientras espera. En caso contrario, si el contador está a cero, retornan de inmediato.
El par CountDownLatch.await/countDown garantiza la visibilidad de datos. Las acciones anteriores a un countDown() que reduce el contador tienen una relación happens-before con las acciones de otro hilo después de que vuelva con éxito de await() o reciba true de la variante con plazo en la misma instancia. Un resultado false no da esa garantía. La compuerta no proporciona exclusión mutua.
Usa un contador por condición. start = 1 da la salida común y done = 3 reúne tres señales de finalización. Para dos grupos, fija immediateReady = 2 y deferredReady = 4. Cada participante avisa una vez de que está listo en su grupo, y el primer grupo no puede continuar hasta que el coordinador abra la compuerta independiente releaseImmediate = 1. Cuando ambos contadores de avisos llegan a cero, sabes sin Thread.sleep que el primer grupo ha dado al menos dos avisos y el segundo al menos cuatro, pero no que los hilos ya estén bloqueados. Con un aviso por participante, solo se garantizan exactamente dos y cuatro avisos si, independientemente de los contadores, se fija que los grupos tengan dos y cuatro participantes, respectivamente. Para coordinar la ocupación de un recurso, usa dos contadores de 1: uno confirma la adquisición y otro da la señal para liberarlo.
Si falta una señal, un hilo puede esperar indefinidamente. Si cuentas intentos terminados, incluidos los fallidos, llama a countDown() en finally y comunica los fallos por separado. El cero confirma que llegaron las señales requeridas, no que el trabajo salió bien.
Ejemplos
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));
}
}Resultado
Start open: false Results: [10, 11, 12] Done open: true
Solo `main` imprime. Primero comprueba que la compuerta sigue cerrada; luego escribe `10` y abre `start`. Cada hilo escribe en su propia posición del array. Después de `done.await()`, `main` ve esas escrituras; la llamada adicional a `done.countDown()` no vuelve a cerrar la compuerta.
Lecciones relacionadas
- Java · Lección 34 · Avanzado · Versión: 2
- Java · Lección 36 · Avanzado · Versión: 2
- Java · Lección 58 · Intermedio · Versión: 2