Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / Java

CyclicBarrier — ciklično usklajevanje niti

CyclicBarrier usklajuje stalno število udeležencev na mejah zaporednih faz. Klic await() počaka na druge; izbirno dejanje združi rezultate, preden se začne naslednja faza.

Različica: Java SE 21; repository runtime, production runtime not attested

Sintaksa

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 iz java.util.concurrent je večkrat uporabna sinhronizacijska točka. Za razliko od enkrat uporabnega CountDownLatch podpira zaporedne cikle. Njen konstruktor zahteva parties >= 1.

CyclicBarrier.await() počaka na vse udeležence in vrne indeks prihoda: zadnji prejme 0. Zadnja nit izvede izbirno dejanje, preden sprosti druge. Zapisovanja pred await() so vidna dejanju, njegovi učinki pa so vidni po uspešni vrnitvi udeležencev.

Prekinitev ali potek časovne omejitve prekine pregrado: prizadeti udeleženec prejme InterruptedException ali TimeoutException, drugi čakajoči udeleženci pa običajno prejmejo BrokenBarrierException. Tudi reset() prekine čakanje; obnovitev zahteva usklajevanje. Poskrbite, da se lahko izvedejo vsi udeleženci, da preprečite nedoločeno čakanje.

Primer uporablja dve niti in dva cikla. Vsaka nit zapiše vrednost v svoj element polja; dejanje izpiše vsoto. Obseg: Java SE 21; produkcijsko izvajalno okolje ni bilo potrjeno.

Primeri

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

Rezultat

3
6

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri