CKTIS / Java
CyclicBarrier: akcja bariery i metoda await
Zsynchronizuj stałą liczbę wątków między fazami, wykonaj jedną wspólną akcję przed ich wznowieniem i rozróżnij oczekiwanie z limitem czasu i bez niego.
Wersja: Java SE 21
Składnia
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);W Java SE 21 klasa java.util.concurrent.CyclicBarrier synchronizuje stałą liczbę wątków przy przejściu między fazami. Konstruktor CyclicBarrier(int,Runnable) przyjmuje liczbę uczestników parties i opcjonalną akcję. Wartość parties < 1 powoduje IllegalArgumentException. Przekazanie null, podobnie jak użycie konstruktora CyclicBarrier(int), oznacza brak akcji.
Metoda instancji CyclicBarrier.await w wersji await() czeka bez limitu czasu na wszystkich uczestników. Ostatni wątek, który dotrze do bariery, wykonuje akcję raz w danej rundzie, zanim którekolwiek wywołanie zakończy się pomyślnie. Wynik typu int to indeks przybycia: parties - 1 dla pierwszego wątku, 0 dla ostatniego. Kod w gałęzi if (barrier.await() == 0) wykonuje się już po zwolnieniu bariery, więc nie zastępuje akcji, która musi zakończyć się przed przejściem pozostałych wątków dalej.
Czynności przed await() są w relacji happens-before z akcją bariery, a akcja jest w tej relacji z czynnościami innych wątków po pomyślnym powrocie z odpowiadającego wywołania. Po udanej rundzie ta sama bariera jest automatycznie gotowa na następną; nie trzeba wywoływać reset().
Wariant await(long timeout, TimeUnit unit) ma limit oczekiwania. Po jego upływie wątek dostaje TimeoutException, a bariera przechodzi w stan uszkodzony. Jeśli await obsłuży przerwanie, gdy runda danego wątku nadal trwa, a bariera nie jest uszkodzona, metoda zgłasza InterruptedException, kasuje znacznik przerwania tego wątku i uszkadza barierę. Jeśli jednak runda zakończy się pomyślnie i bariera przejdzie do następnej rundy, zanim oczekujący wątek obsłuży przerwanie, await może zwrócić indeks przybycia z ustawionym znacznikiem przerwania (przywróconym w razie potrzeby). Wyjątek z akcji trafia do ostatniego wątku i także uszkadza barierę. Pozostali oczekujący zwykle dostają BrokenBarrierException; dostają go również wywołania na już uszkodzonej barierze. reset() przywraca stan początkowy, ale przerywa bieżące oczekiwanie przez BrokenBarrierException, więc odzyskiwanie wymaga koordynacji.
Przykłady
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();
}
}
}
}Wynik
Phase 1 Phase 1 Phase 1 4: Barrier action Phase 2 Phase 2 Phase 2
Trzy zadania korzystają z trzech wątków puli i przechodzą przez barierę tylko raz. `4: Barrier action` to czwarty wiersz, nie czwarty uczestnik. Każda faza ma identyczne komunikaty dla wszystkich zadań, więc kolejność wątków nie zmienia wyniku.
Powiązane lekcje
- Java · Lekcja 34 · Zaawansowany · Wersja: 2