Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / Java

Phaser: registrace, čekání na změnu fáze a odhlášení

Pomocí `Phaser` synchronizujte úlohy v opakovaných fázích, přidejte účastníka během fáze a ukončete bariéru, když se odhlásí poslední účastník.

Verze: Java SE 21

Syntaxe

import java.util.concurrent.Phaser;

Phaser phaser = new Phaser(1); // Signature: Phaser(int parties)
int registrationPhase = phaser.register();
phaser.arriveAndAwaitAdvance();
int arrivalPhase = phaser.arriveAndDeregister();

java.util.concurrent.Phaser je v Java SE 21 opakovaně použitelná bariéra s proměnným počtem účastníků. Phaser(int) začíná ve fázi 0 bez nadřazené bariéry a s daným počtem registrovaných účastníků, kteří dosud neohlásili příchod. Phaser() začíná bez účastníků. Záporný počet nebo hodnota nad limitem této implementace (65 535) vyvolá IllegalArgumentException.

register() přidá jednoho účastníka, který ještě musí ohlásit příchod, a vrátí číslo fáze, pro niž registrace platí. Po ukončení bariéry nic nezmění a vrátí zápornou hodnotu. Pokus překročit limit registrací vyvolá IllegalStateException.

arriveAndAwaitAdvance() ohlásí příchod a čeká na změnu fáze nebo ukončení bariéry; účastník zůstává registrován. Samotné přerušení vlákna čekání neukončí. Pro přerušitelné čekání nebo časový limit oddělte arrive() od příslušné přetížené varianty awaitAdvanceInterruptibly(...). arriveAndDeregister() ohlásí příchod a odhlásí účastníka z dalších fází, aniž by čekal na ostatní. Vrátí fázi příchodu nebo zápornou hodnotu, pokud už bariéra byla ukončena.

Bariéra eviduje počty, nikoli totožnost vláken. Za každého účastníka ohlaste v každé fázi právě jeden příchod: chybějící příchod může zablokovat ostatní a chybný příchod nemusí ihned vyvolat výjimku. Po odhlášení posledního účastníka výchozí onAdvance(int, int) bariéru při uzavření fáze ukončí. Stav ověříte pomocí isTerminated().

Ve fázi 0 využije main místo z konstruktoru, zaregistruje tři pracovní vlákna před jejich spuštěním a ohlásí vlastní příchod pomocí arrive(). Čtvrté vlákno se zaregistruje v téže fázi a pak prostřednictvím CompletableFuture uvolní první tři. main nemůže pokračovat za awaitAdvance(...), dokud nedorazí všechna čtyři vlákna. Ve fázi 1 všech pět účastníků ohlásí příchod a čeká, ve fázi 2 všichni ohlásí příchod a odhlásí se.

Příklady

import java.util.concurrent.CompletableFuture;
import java.util.concurrent.Phaser;

public class PhaserDemo {
    private static void runWorker(Phaser phaser) {
        phaser.arriveAndAwaitAdvance();  // Phase 0
        phaser.arriveAndAwaitAdvance();  // Phase 1
        phaser.arriveAndDeregister();    // Phase 2
    }

    public static void main(String[] args) throws InterruptedException {
        Phaser phaser = new Phaser(1);
        CompletableFuture<Void> lateWorkerRegistered = new CompletableFuture<>();
        Thread[] workers = new Thread[4];

        for (int i = 0; i < 3; i++) {
            phaser.register();
            workers[i] = new Thread(() -> {
                lateWorkerRegistered.join();
                runWorker(phaser);
            });
            workers[i].start();
        }

        int phaseZero = phaser.arrive();
        workers[3] = new Thread(() -> {
            phaser.register();
            lateWorkerRegistered.complete(null);
            runWorker(phaser);
        });
        workers[3].start();

        phaser.awaitAdvance(phaseZero);
        System.out.println("Phase 0 complete: " + phaser.getRegisteredParties() + " registered");
        phaser.arriveAndAwaitAdvance();
        System.out.println("Phase 1 complete");
        phaser.arriveAndDeregister();

        for (Thread worker : workers) {
            worker.join();
        }
        System.out.println("Phase 2 complete: terminated = " + phaser.isTerminated());
    }
}

Výsledek

Phase 0 complete: 5 registered
Phase 1 complete
Phase 2 complete: terminated = true

Vypisuje pouze `main`. Po fázi 0 je stále registrováno pět účastníků, protože fáze 1 nemůže skončit bez příchodu `main`. Poslední řádek se vypíše po návratu `join()` pro všechna čtyři pracovní vlákna.

Související lekce

  • Java · Lekce 35 · Pokročilá · Verze: 2

Zdroje