CKTIS / Java
CyclicBarrier: barrièreactie en await
Synchroniseer een vast aantal threads tussen fasen, voer één gezamenlijke actie uit voordat ze doorgaan en onderscheid wachten met en zonder tijdslimiet.
Versie: 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);In Java SE 21 synchroniseert java.util.concurrent.CyclicBarrier een vast aantal threads bij de overgang tussen fasen. CyclicBarrier(int,Runnable) neemt het aantal deelnemers en een optionele actie. Een aantal kleiner dan 1 veroorzaakt IllegalArgumentException. Met null of met de constructor CyclicBarrier(int) is er geen actie.
De instantiemethode CyclicBarrier.await wacht in de variant zonder argumenten, await(), zonder tijdslimiet op alle deelnemers. De laatste thread die aankomt, voert de actie één keer per ronde uit voordat een aanroep succesvol terugkeert. Het int-resultaat is de aankomstindex: parties - 1 voor de eerste thread en 0 voor de laatste. Een blok met if (barrier.await() == 0) wordt pas uitgevoerd nadat de groep is vrijgegeven. Het vervangt dus geen actie die klaar moet zijn voordat de andere threads doorgaan.
Werk vóór await() staat in een happens-before-relatie tot de barrièreactie. Diezelfde relatie geldt tussen de actie en het werk van andere threads nadat hun overeenkomstige aanroep succesvol is teruggekeerd. Na een geslaagde ronde is dezelfde barrière automatisch klaar voor de volgende, zonder reset().
await(long timeout, TimeUnit unit) begrenst de wachttijd. Als die verstrijkt, krijgt de aanroeper TimeoutException en raakt de barrière defect. Als await een interrupt verwerkt terwijl de ronde van de thread nog loopt en de barrière niet defect is, gooit de methode InterruptedException, wist ze de interruptstatus van de thread en maakt ze de barrière defect. Als de ronde daarentegen slaagt en de barrière naar de volgende ronde overgaat voordat de wachtende thread de interrupt verwerkt, kan await de aankomstindex teruggeven met de interruptstatus van de thread nog steeds of opnieuw ingesteld. Een uitzondering in de actie bereikt de laatst aangekomen thread en maakt de barrière eveneens defect. Andere wachtende threads krijgen doorgaans BrokenBarrierException, net als aanroepen op een al defecte barrière. reset() herstelt de begintoestand, maar breekt lopende wachtaanroepen af met BrokenBarrierException. Stem herstel daarom af.
Voorbeelden
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();
}
}
}
}Resultaat
Phase 1 Phase 1 Phase 1 4: Barrier action Phase 2 Phase 2 Phase 2
Drie taken gebruiken drie poolthreads en passeren de barrière één keer. `4: Barrier action` is de vierde uitvoerregel, geen vierde deelnemer. Binnen een fase schrijven alle taken dezelfde tekst, zodat hun uitvoeringsvolgorde de uitvoer niet verandert.
Gerelateerde lessen
- Java · Les 34 · Gevorderd · Versie: 2