Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / Java

CyclicBarrier — sincronización cíclica de hilos

CyclicBarrier sincroniza a un número fijo de participantes en los límites de fases sucesivas. La llamada a await() espera a los demás; una acción opcional combina los resultados antes de que empiece la fase siguiente.

Versión: Java SE 21; repository runtime, production runtime not attested

Sintaxis

new CyclicBarrier(int parties)
new CyclicBarrier(int parties, Runnable barrierAction)
int await() throws InterruptedException, BrokenBarrierException
int await(long timeout, TimeUnit unit) throws InterruptedException, BrokenBarrierException, TimeoutException

CyclicBarrier, de java.util.concurrent, es un punto de sincronización reutilizable. A diferencia de CountDownLatch, que solo se usa una vez, admite ciclos sucesivos. Su constructor requiere parties >= 1.

CyclicBarrier.await() espera a todos los participantes y devuelve un índice de llegada: el último recibe 0. El último hilo ejecuta la acción opcional antes de liberar a los demás. Las escrituras anteriores a await() son visibles para la acción, y las acciones de esta son visibles después de que los participantes regresen correctamente.

Una interrupción o el vencimiento del tiempo límite rompe la barrera: el participante afectado recibe InterruptedException o TimeoutException, mientras que los demás participantes en espera normalmente reciben BrokenBarrierException. reset() también interrumpe la espera; la recuperación requiere coordinación. Asegúrate de que todos los participantes puedan ejecutarse para evitar una espera indefinida.

El ejemplo usa dos hilos y dos ciclos. Cada hilo escribe en su propio elemento del array; la acción imprime la suma. Ámbito: Java SE 21; el entorno de ejecución de producción no ha sido certificado.

Ejemplos

import java.util.concurrent.BrokenBarrierException;
import java.util.concurrent.CyclicBarrier;

public class BarrierDemo {
    public static void main(String[] args) throws InterruptedException {
        int[] values = new int[2];
        CyclicBarrier barrier = new CyclicBarrier(2,
                () -> System.out.println(values[0] + values[1]));

        Thread[] workers = new Thread[2];
        for (int i = 0; i < workers.length; i++) {
            final int index = i;
            workers[i] = new Thread(() -> {
                try {
                    for (int phase = 1; phase <= 2; phase++) {
                        values[index] = (index + 1) * phase;
                        barrier.await();
                    }
                } catch (InterruptedException e) {
                    Thread.currentThread().interrupt();
                } catch (BrokenBarrierException e) {
                    throw new IllegalStateException(e);
                }
            });
            workers[i].start();
        }
        for (Thread worker : workers) {
            worker.join();
        }
    }
}

Resultado

3
6

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.

Fuentes