База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / Java

CyclicBarrier: действие на бариерата и метод await

Синхронизирайте фиксиран брой нишки между фази, изпълнете общо действие, преди да продължат, и разграничете изчакването със и без ограничение във времето.

Версия: Java SE 21

Синтаксис

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

В Java SE 21 класът java.util.concurrent.CyclicBarrier синхронизира фиксиран брой нишки на границата между фази. Конструкторът CyclicBarrier(int,Runnable) приема брой участници и незадължително действие. Стойност под 1 води до IllegalArgumentException. Подаването на null или използването на CyclicBarrier(int) означава, че няма действие.

Методът на екземпляра CyclicBarrier.await във варианта без аргументи await() изчаква всички участници без ограничение във времето. Последната пристигнала нишка изпълнява действието веднъж за цикъл, преди което и да е извикване да завърши успешно. Резултатът от тип int е индексът на пристигане: parties - 1 за първата нишка и 0 за последната. Блокът if (barrier.await() == 0) се изпълнява след освобождаването на групата и затова не замества действие, което трябва да приключи, преди останалите нишки да продължат.

Операциите преди await() предхождат действието на бариерата в смисъла на връзката happens-before. Действието на свой ред предхожда операциите на другите нишки след успешното връщане от съответното извикване. След успешен цикъл същата бариера е автоматично готова за следващия, без да е нужно извикване на reset().

await(long timeout, TimeUnit unit) ограничава времето за изчакване. При изтичането му извикващата нишка получава TimeoutException и бариерата преминава в нарушено състояние. Ако await обработи прекъсване, докато цикълът на нишката още тече и бариерата не е нарушена, методът хвърля InterruptedException, изчиства флага за прекъсване на нишката и нарушава бариерата. Ако обаче цикълът завърши успешно и бариерата премине към следващия, преди чакащата нишка да обработи прекъсването, await може да върне индекса на пристигане с вдигнат флаг за прекъсване, като при нужда го вдига отново. Изключение от действието се предава на последната пристигнала нишка и също нарушава бариерата. Другите чакащи нишки обикновено получават BrokenBarrierException, както и извикванията върху вече нарушена бариера. reset() възстановява началното състояние, но прекратява текущите изчаквания с BrokenBarrierException, затова възстановяването трябва да се координира.

Примери

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

Резултат

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

Три задачи използват три нишки от пула и преминават през бариерата само веднъж. `4: Barrier action` е четвъртият ред от изхода, а не четвърти участник. Във всяка фаза задачите отпечатват един и същ текст, затова редът на изпълнение не променя изхода.

Свързани уроци

  • Java · Урок 34 · Напреднало · Версия: 2

Източници