CKTIS / Java
CyclicBarrier: akcia bariéry a metóda await
Synchronizujte pevný počet vlákien medzi fázami, vykonajte spoločnú akciu pred ich pokračovaním a rozlišujte čakanie s časovým limitom a bez neho.
Verzia: Java SE 21
Syntax
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 trieda java.util.concurrent.CyclicBarrier synchronizuje pevný počet vlákien na rozhraní fáz. Konštruktor CyclicBarrier(int,Runnable) prijíma počet účastníkov a voliteľnú akciu. Hodnota menšia než 1 vyvolá IllegalArgumentException. Odovzdanie null alebo použitie konštruktora CyclicBarrier(int) znamená, že sa žiadna akcia nevykoná.
Inštančná metóda CyclicBarrier.await vo variante await() bez argumentov čaká na všetkých účastníkov bez časového limitu. Posledné prichádzajúce vlákno vykoná akciu raz za kolo, skôr než sa ktorékoľvek volanie úspešne vráti. Výsledkom typu int je index príchodu: parties - 1 pre prvé vlákno a 0 pre posledné. Vetva if (barrier.await() == 0) sa vykoná až po uvoľnení skupiny, takže nenahradí akciu, ktorá sa musí skončiť pred pokračovaním ostatných vlákien.
Práca pred await() predchádza akcii bariéry vo vzťahu happens-before. Akcia v rovnakom zmysle predchádza práci ostatných vlákien po úspešnom návrate zo zodpovedajúceho volania. Po úspešnom kole je tá istá bariéra automaticky pripravená na ďalšie kolo; reset() netreba.
await(long timeout, TimeUnit unit) obmedzuje čas čakania. Po uplynutí limitu dostane volajúci TimeoutException a bariéra prejde do porušeného stavu. Ak await spracuje prerušenie, kým kolo daného vlákna ešte prebieha a bariéra nie je porušená, vyvolá InterruptedException, vymaže príznak prerušenia vlákna a poruší bariéru. Ak sa však kolo úspešne skončí a bariéra prejde do ďalšieho kola skôr, než čakajúce vlákno spracuje prerušenie, await môže vrátiť index príchodu s nastaveným príznakom prerušenia, ktorý v prípade potreby obnoví. Výnimka z akcie sa prenesie do posledného prichádzajúceho vlákna a takisto poruší bariéru. Ostatné čakajúce vlákna zvyčajne dostanú BrokenBarrierException, rovnako ako volania na už porušenej bariére. reset() obnoví počiatočný stav, ale prebiehajúce čakania ukončí výnimkou BrokenBarrierException, preto treba obnovu koordinovať.
Prí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ýsledok
Phase 1 Phase 1 Phase 1 4: Barrier action Phase 2 Phase 2 Phase 2
Tri úlohy používajú tri vlákna z fondu a prejdú bariérou iba raz. `4: Barrier action` je štvrtý riadok výstupu, nie štvrtý účastník. V každej fáze úlohy vypisujú rovnaký text, takže poradie ich vykonávania výstup nemení.
Súvisiace lekcie
- Java · Lekcia 34 · Pokročilá · Verzia: 2