Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / Java

CyclicBarrier: akce bariéry a metoda await

Synchronizujte pevný počet vláken mezi fázemi, spusťte společnou akci před jejich pokračováním a rozlišujte čekání s časovým limitem a bez něj.

Verze: Java SE 21

Syntaxe

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

V Java SE 21 třída java.util.concurrent.CyclicBarrier synchronizuje pevný počet vláken na hranici dvou fází. Konstruktor CyclicBarrier(int,Runnable) přijímá počet účastníků a volitelnou akci. Hodnota menší než 1 vyvolá IllegalArgumentException. Předání null nebo použití konstruktoru CyclicBarrier(int) znamená, že se žádná akce neprovede.

Instanční metoda CyclicBarrier.await ve variantě await() bez argumentů čeká na všechny účastníky bez časového limitu. Poslední příchozí vlákno provede akci jednou za kolo, než se kterékoli volání úspěšně vrátí. Výsledkem typu int je index příchodu: parties - 1 pro první a 0 pro poslední vlákno. Větev if (barrier.await() == 0) se provádí až po uvolnění skupiny, takže nenahradí akci, která musí skončit dřív, než ostatní vlákna pokračují.

Práce před await() předchází akci bariéry ve smyslu vztahu happens-before. Akce ve stejném smyslu předchází práci ostatních vláken po úspěšném návratu z odpovídajícího volání. Po úspěšném kole je tatáž bariéra automaticky připravena na další kolo; reset() není potřeba.

await(long timeout, TimeUnit unit) omezuje dobu čekání. Po vypršení limitu dostane volající TimeoutException a bariéra přejde do porušeného stavu. Pokud await zpracuje přerušení, dokud kolo daného vlákna stále probíhá a bariéra není porušená, vyvolá InterruptedException, vymaže příznak přerušení vlákna a poruší bariéru. Pokud se však kolo úspěšně dokončí a bariéra přejde do dalšího kola dříve, než čekající vlákno přerušení zpracuje, může await vrátit index příchodu s nastaveným příznakem přerušení, který v případě potřeby obnoví. Výjimka z akce se propaguje do posledního příchozího vlákna a rovněž poruší bariéru. Ostatní čekající vlákna obvykle dostanou BrokenBarrierException, stejně jako volání na již porušené bariéře. reset() obnoví počáteční stav, ale ukončí probíhající čekání výjimkou BrokenBarrierException, proto je nutné obnovu koordinovat.

Příklady

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

Výsledek

Phase 1
Phase 1
Phase 1
4: Barrier action
Phase 2
Phase 2
Phase 2

Tři úlohy používají tři vlákna z fondu a projdou bariérou jen jednou. `4: Barrier action` je čtvrtý řádek výstupu, nikoli čtvrtý účastník. V rámci každé fáze úlohy vypisují stejný text, takže pořadí jejich běhu výstup nemění.

Související lekce

  • Java · Lekce 34 · Pokročilá · Verze: 2

Zdroje