Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / Java

CyclicBarrier: dejanje pregrade in metoda await

Uskladite določeno število niti med fazami, izvedite skupno dejanje, preden lahko nadaljujejo, in ločite časovno omejeno čakanje od neomejenega.

Različica: 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);

V Java SE 21 razred java.util.concurrent.CyclicBarrier uskladi določeno število niti na prehodu med fazama. Konstruktor CyclicBarrier(int,Runnable) sprejme število udeležencev in neobvezno dejanje. Število, manjše od 1, povzroči IllegalArgumentException. Če podate null ali uporabite konstruktor CyclicBarrier(int), se dejanje ne izvede.

Primerkovna metoda CyclicBarrier.await v obliki await() brez argumentov čaka na vse udeležence brez časovne omejitve. Zadnja nit, ki prispe, izvede dejanje enkrat na krog, preden se kateri koli klic uspešno vrne. Rezultat tipa int je indeks prihoda: parties - 1 za prvo in 0 za zadnjo nit. Blok if (barrier.await() == 0) se izvede šele po sprostitvi skupine, zato ne nadomesti dejanja, ki se mora končati, preden druge niti nadaljujejo.

Delo pred await() je v relaciji happens-before z dejanjem pregrade, dejanje pa je v isti relaciji z delom drugih niti po uspešni vrnitvi iz ustreznega klica. Po uspešnem krogu je ista pregrada samodejno pripravljena na naslednjega; klic reset() ni potreben.

await(long timeout, TimeUnit unit) omeji čas čakanja. Če se čas izteče, klicatelj dobi TimeoutException, pregrada pa preide v okvarjeno stanje. Če await obravnava prekinitev, ko krog niti še traja in pregrada ni okvarjena, sproži InterruptedException, počisti oznako prekinitve niti in postavi pregrado v okvarjeno stanje. Če pa se krog uspešno konča in pregrada preide v naslednji krog, preden čakajoča nit obravnava prekinitev, lahko await vrne indeks prihoda z nastavljeno oznako prekinitve, ki jo po potrebi znova nastavi. Izjema iz dejanja se prenese v zadnjo prispelo nit in tudi pokvari pregrado. Druge čakajoče niti praviloma dobijo BrokenBarrierException, enako kot klici na že okvarjeni pregradi. reset() obnovi začetno stanje, vendar konča trenutna čakanja z BrokenBarrierException, zato je treba obnovitev uskladiti.

Primeri

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 opravila uporabljajo tri niti iz nabora in pregrado prečkajo samo enkrat. `4: Barrier action` je četrta vrstica izpisa, ne četrti udeleženec. V posamezni fazi vsa opravila izpišejo isto besedilo, zato vrstni red izvajanja ne spremeni izpisa.

Povezane lekcije

  • Java · Lekcija 34 · Napredna · Različica: 2

Viri