KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / Java

CyclicBarrier — cyclische threadsynchronisatie

CyclicBarrier synchroniseert een vast aantal deelnemers bij opeenvolgende fasegrenzen. De aanroep await() wacht op de anderen; een optionele actie combineert resultaten voordat de volgende fase begint.

Versie: Java SE 21; repository runtime, production runtime not attested

Syntax

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 uit java.util.concurrent is een herbruikbaar synchronisatiepunt. In tegenstelling tot de eenmalige CountDownLatch ondersteunt deze opeenvolgende cycli. De constructor vereist parties >= 1.

CyclicBarrier.await() wacht op alle deelnemers en retourneert een aankomstindex: de laatst aangekomen deelnemer krijgt 0. De laatste thread voert de optionele actie uit voordat de anderen worden vrijgegeven. Schrijfacties vóór await() zijn zichtbaar voor de actie; de acties daarvan zijn zichtbaar nadat de deelnemers succesvol zijn teruggekeerd.

Een onderbreking of time-out verbreekt de barrière: de getroffen deelnemer ontvangt InterruptedException of TimeoutException, terwijl andere wachtende deelnemers doorgaans BrokenBarrierException ontvangen. Ook reset() onderbreekt het wachten; herstel vereist coördinatie. Zorg dat alle deelnemers kunnen worden uitgevoerd om onbeperkt wachten te voorkomen.

Het voorbeeld gebruikt twee threads en twee cycli. Elke thread schrijft naar zijn eigen array-element; de actie drukt de som af. Reikwijdte: Java SE 21; de productie-runtime is niet bevestigd.

Voorbeelden

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();
        }
    }
}

Resultaat

3
6

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen