KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / Java

Phaser: registreren, wachten op de volgende fase en afmelden

Gebruik `Phaser` om taken over meerdere fasen te synchroniseren, tijdens een fase een deelnemer toe te voegen en de barrière te beëindigen zodra de laatste deelnemer vertrekt.

Versie: 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 is in Java SE 21 een herbruikbare barrière met een wisselend aantal deelnemers. Phaser(int) begint zonder bovenliggende barrière in fase 0 met het opgegeven aantal geregistreerde deelnemers dat zich nog niet aan de barrière heeft gemeld. Phaser() begint zonder deelnemers. Een negatief aantal of een aantal boven de implementatiegrens van 65.535 veroorzaakt IllegalArgumentException.

register() voegt één deelnemer toe die nog aankomst moet melden en geeft de fase terug waarvoor de registratie geldt. Na beëindiging verandert er niets en is de retourwaarde negatief. Een registratie die de deelnemerslimiet overschrijdt, veroorzaakt IllegalStateException.

arriveAndAwaitAdvance() meldt aankomst en wacht op de faseovergang of het einde van de barrière, zonder de deelnemer af te melden. Een interrupt alleen beëindigt het wachten niet. Splits voor onderbreekbaar wachten of een tijdslimiet arrive() en de passende overload van awaitAdvanceInterruptibly(...). arriveAndDeregister() meldt aankomst en verwijdert de deelnemer uit volgende fasen zonder op anderen te wachten. De methode geeft de aankomstfase terug, of een negatieve waarde als de barrière al beëindigd was.

De barrière houdt aantallen bij, geen threadidentiteiten. Meld per deelnemer per fase één aankomst: een ontbrekende melding kan anderen blokkeren en een ongeldige melding hoeft niet direct een uitzondering te veroorzaken. Zodra de laatste deelnemer zich afmeldt, beëindigt de standaardimplementatie van onAdvance(int, int) de barrière aan het eind van de fase. Controleer die toestand met isTerminated().

In fase 0 gebruikt main de plek uit de constructor, registreert drie workerthreads vóór de start en meldt de eigen aankomst met arrive(). Een vierde worker registreert zich nog in dezelfde fase en geeft daarna de eerste drie via een CompletableFuture vrij. main kan pas voorbij awaitAdvance(...) als alle vier zijn aangekomen. In fase 1 melden alle vijf hun aankomst en wachten ze; in fase 2 melden ze hun aankomst en schrijven ze zich uit.

Voorbeelden

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

Resultaat

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

Alleen `main` schrijft naar de console. Na fase 0 zijn nog vijf deelnemers geregistreerd, want fase 1 kan niet eindigen zonder de aankomst van `main`. De laatste regel verschijnt nadat `join()` voor alle vier de workerthreads is teruggekeerd.

Gerelateerde lessen

  • Java · Les 35 · Gevorderd · Versie: 2

Bronnen