Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / Java

Phaser: registrácia, čakanie na zmenu fázy a odhlásenie

Pomocou `Phaser` synchronizujte úlohy v opakovaných fázach, pridajte účastníka počas fázy a ukončite bariéru, keď sa odhlási posledný účastník.

Verzia: Java SE 21

Syntax

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 opakovane použiteľná bariéra s premenlivým počtom účastníkov. Phaser(int) začína vo fáze 0 bez nadradenej bariéry a s daným počtom zaregistrovaných účastníkov, ktorí ešte neohlásili príchod. Phaser() začína bez účastníkov. Záporný počet alebo hodnota nad limitom tejto implementácie (65 535) vyvolá IllegalArgumentException.

register() pridá jedného účastníka, ktorý ešte musí ohlásiť príchod, a vráti číslo fázy, pre ktorú registrácia platí. Po ukončení bariéry nič nezmení a vráti zápornú hodnotu. Pokus prekročiť limit registrácií vyvolá IllegalStateException.

arriveAndAwaitAdvance() ohlási príchod a čaká na zmenu fázy alebo ukončenie bariéry, pričom účastník ostáva zaregistrovaný. Samotné prerušenie vlákna čakanie neukončí. Pre prerušiteľné čakanie alebo časový limit oddeľte arrive() od vhodného preťaženia awaitAdvanceInterruptibly(...). arriveAndDeregister() ohlási príchod a odhlási účastníka z ďalších fáz bez čakania na ostatných. Vráti fázu príchodu alebo zápornú hodnotu, ak už bola bariéra ukončená.

Bariéra eviduje počty, nie identitu vlákien. Za každého účastníka ohláste v každej fáze práve jeden príchod: chýbajúci príchod môže zablokovať ostatných a chybný príchod nemusí ihneď vyvolať výnimku. Keď sa odhlási posledný účastník, predvolené onAdvance(int, int) pri uzavretí fázy ukončí bariéru. Stav overíte pomocou isTerminated().

Vo fáze 0 využije main miesto z konštruktora, zaregistruje tri pracovné vlákna pred ich spustením a ohlási vlastný príchod pomocou arrive(). Štvrté vlákno sa zaregistruje ešte v tej istej fáze a potom pomocou CompletableFuture uvoľní prvé tri. main nemôže pokračovať za awaitAdvance(...), kým neprídu všetky štyri vlákna. Vo fáze 1 všetci piati účastníci ohlásia príchod a čakajú, vo fáze 2 všetci ohlásia príchod a odhlásia sa.

Prí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ýsledok

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

Vypisuje iba `main`. Po fáze 0 je stále zaregistrovaných päť účastníkov, lebo fáza 1 sa nemôže skončiť bez príchodu `main`. Posledný riadok sa vypíše po návrate `join()` pre všetky štyri pracovné vlákna.

Súvisiace lekcie

  • Java · Lekcia 35 · Pokročilá · Verzia: 2

Zdroje