Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / Java

CyclicBarrier: akcija barijere i metoda await

Uskladite fiksan broj dretvi između faza, izvršite zajedničku akciju prije nego što nastave i razlikujte čekanje s vremenskim ograničenjem od čekanja bez njega.

Verzija: Java SE 21

Sintaksa

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

U Javi SE 21 klasa java.util.concurrent.CyclicBarrier usklađuje fiksan broj dretvi na prijelazu između faza. Konstruktor CyclicBarrier(int,Runnable) prima broj sudionika i neobaveznu akciju. Vrijednost manja od 1 uzrokuje IllegalArgumentException. Prosljeđivanje vrijednosti null ili upotreba konstruktora CyclicBarrier(int) znači da nema akcije.

Metoda instance CyclicBarrier.await u obliku await() bez argumenata čeka sve sudionike bez vremenskog ograničenja. Posljednja dretva koja stigne izvršava akciju jednom po krugu, prije nego što se ijedan poziv uspješno vrati. Rezultat tipa int jest indeks dolaska: parties - 1 za prvu i 0 za posljednju dretvu. Blok if (barrier.await() == 0) izvršava se nakon oslobađanja skupine, pa ne zamjenjuje akciju koja mora završiti prije nego što ostale dretve nastave.

Rad prije await() prethodi akciji barijere u smislu odnosa happens-before. Akcija u istom smislu prethodi radu drugih dretvi nakon uspješnog povratka iz odgovarajućeg poziva. Nakon uspješnog kruga ista je barijera automatski spremna za sljedeći; reset() nije potreban.

await(long timeout, TimeUnit unit) ograničava trajanje čekanja. Ako rok istekne, pozivatelj dobiva TimeoutException, a barijera prelazi u neispravno stanje. Ako await obradi prekid dok krug te dretve još traje i barijera nije u neispravnom stanju, baca InterruptedException, briše oznaku prekida dretve i dovodi barijeru u neispravno stanje. Ako se pak krug uspješno završi i barijera prijeđe u sljedeći krug prije nego što dretva na čekanju obradi prekid, await može vratiti indeks dolaska s postavljenom oznakom prekida, koju po potrebi ponovno postavlja. Iznimka iz akcije prenosi se posljednjoj pristigloj dretvi i ima isti učinak na barijeru. Ostale dretve na čekanju u pravilu dobivaju BrokenBarrierException, kao i pozivi na već neispravnoj barijeri. reset() vraća početno stanje, ali prekida trenutačna čekanja iznimkom BrokenBarrierException, pa oporavak treba koordinirati.

Primjeri

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

Rezultat

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

Tri zadatka koriste tri dretve iz skupa i prolaze kroz barijeru samo jednom. `4: Barrier action` četvrti je redak ispisa, a ne četvrti sudionik. U svakoj fazi svi zadaci ispisuju isti tekst, pa redoslijed izvršavanja ne mijenja ispis.

Povezane lekcije

  • Java · Lekcija 34 · Napredno · Verzija: 2

Izvori