CKTIS / Java
CyclicBarrier: acción de barrera y método await
Sincroniza un número fijo de hilos entre fases, ejecuta una acción común antes de que continúen y distingue la espera con límite de tiempo de la espera sin él.
Versión: Java SE 21
Sintaxis
import java.util.concurrent.CyclicBarrier;
import java.util.concurrent.TimeUnit;
CyclicBarrier barrier = new CyclicBarrier(parties, barrierAction);
int arrivalIndex = barrier.await();
// Alternative for an arrival with a time limit:
int timedArrivalIndex = barrier.await(timeout, TimeUnit.SECONDS);En Java SE 21, java.util.concurrent.CyclicBarrier sincroniza un número fijo de hilos en el límite entre fases. El constructor CyclicBarrier(int,Runnable) recibe el número de participantes y una acción opcional. Un número menor que 1 provoca IllegalArgumentException. Pasar null o usar CyclicBarrier(int) significa que no hay acción.
El método de instancia CyclicBarrier.await, en su forma sin argumentos await(), espera a todos los participantes sin límite de tiempo. El último hilo en llegar ejecuta la acción una vez por ronda, antes de que ninguna llamada retorne con éxito. El resultado de tipo int es el índice de llegada: parties - 1 para el primero y 0 para el último. El bloque if (barrier.await() == 0) se ejecuta después de liberar al grupo, por lo que no sustituye una acción que debe terminar antes de que los demás hilos continúen.
El trabajo anterior a await() precede, en el sentido de la relación happens-before, a la acción de barrera, y esta precede al trabajo de los demás hilos tras el retorno satisfactorio de la llamada correspondiente. Tras una ronda completada con éxito, la misma barrera queda lista para la siguiente sin llamar a reset().
await(long timeout, TimeUnit unit) limita la espera. Si vence el plazo, el hilo que hizo la llamada recibe TimeoutException y la barrera se rompe. Si await procesa una interrupción mientras la ronda del hilo sigue en curso y la barrera no está rota, lanza InterruptedException, borra el indicador de interrupción del hilo y rompe la barrera. Si, en cambio, la ronda termina con éxito y la barrera pasa a la siguiente antes de que el hilo en espera procese la interrupción, await puede devolver el índice de llegada con el indicador de interrupción activado, restablecido si es necesario. Una excepción en la acción se propaga al último hilo en llegar y también rompe la barrera. Los demás hilos en espera suelen recibir BrokenBarrierException, igual que las llamadas a una barrera ya rota. reset() restaura el estado inicial, pero hace fallar las esperas en curso con BrokenBarrierException, por lo que hay que coordinar la recuperación.
Ejemplos
import java.util.List;
import java.util.concurrent.Callable;
import java.util.concurrent.CyclicBarrier;
import java.util.concurrent.ExecutionException;
import java.util.concurrent.Executors;
public class BarrierPhases {
public static void main(String[] args) throws InterruptedException, ExecutionException {
int parties = 3;
var barrier = new CyclicBarrier(parties,
() -> System.out.println("4: Barrier action"));
Callable<Void> worker = () -> {
System.out.println("Phase 1");
barrier.await();
System.out.println("Phase 2");
return null;
};
try (var pool = Executors.newFixedThreadPool(parties)) {
for (var result : pool.invokeAll(List.of(worker, worker, worker))) {
result.get();
}
}
}
}Resultado
Phase 1 Phase 1 Phase 1 4: Barrier action Phase 2 Phase 2 Phase 2
Tres tareas usan tres hilos del pool y cruzan la barrera una sola vez. `4: Barrier action` es la cuarta línea de salida, no un cuarto participante. Todas las tareas imprimen el mismo texto dentro de cada fase, así que su orden de ejecución no cambia la salida.
Lecciones relacionadas
- Java · Lección 34 · Avanzado · Versión: 2