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

CKTIS / Java

CyclicBarrier — циклична синхронизация на нишки

CyclicBarrier синхронизира фиксиран брой участници на границите на последователни фази. Извикването на await() изчаква останалите; незадължително действие обединява резултатите, преди да започне следващата фаза.

Версия: Java SE 21; repository runtime, production runtime not attested

Синтаксис

new CyclicBarrier(int parties)
new CyclicBarrier(int parties, Runnable barrierAction)
int await() throws InterruptedException, BrokenBarrierException
int await(long timeout, TimeUnit unit) throws InterruptedException, BrokenBarrierException, TimeoutException

CyclicBarrier от java.util.concurrent е многократно използваема точка за синхронизация. За разлика от еднократния CountDownLatch, тя поддържа последователни цикли. Конструкторът ѝ изисква parties >= 1.

CyclicBarrier.await() изчаква всички участници и връща индекс на пристигане: последният получава 0. Последната нишка изпълнява незадължителното действие, преди да освободи останалите. Записите преди await() са видими за действието, а действията му са видими след успешното връщане на участниците.

Прекъсване или изтичане на времето за изчакване нарушава бариерата: засегнатият участник получава InterruptedException или TimeoutException, а останалите чакащи участници обикновено получават BrokenBarrierException. reset() също прекъсва изчакването; възстановяването изисква координация. Уверете се, че всички участници могат да се изпълнят, за да избегнете безкрайно изчакване.

Примерът използва две нишки и два цикъла. Всяка нишка записва в собствен елемент на масива; действието отпечатва сумата. Обхват: Java SE 21; производствената среда за изпълнение не е потвърдена.

Примери

import java.util.concurrent.BrokenBarrierException;
import java.util.concurrent.CyclicBarrier;

public class BarrierDemo {
    public static void main(String[] args) throws InterruptedException {
        int[] values = new int[2];
        CyclicBarrier barrier = new CyclicBarrier(2,
                () -> System.out.println(values[0] + values[1]));

        Thread[] workers = new Thread[2];
        for (int i = 0; i < workers.length; i++) {
            final int index = i;
            workers[i] = new Thread(() -> {
                try {
                    for (int phase = 1; phase <= 2; phase++) {
                        values[index] = (index + 1) * phase;
                        barrier.await();
                    }
                } catch (InterruptedException e) {
                    Thread.currentThread().interrupt();
                } catch (BrokenBarrierException e) {
                    throw new IllegalStateException(e);
                }
            });
            workers[i].start();
        }
        for (Thread worker : workers) {
            worker.join();
        }
    }
}

Резултат

3
6

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници