Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / Java

Phaser: registar, esperar pela mudança de fase e cancelar o registo

Use `Phaser` para sincronizar tarefas em fases sucessivas, aceitar um novo participante durante uma fase e terminar a barreira quando o último participante sair.

Versão: Java SE 21

Sintaxe

import java.util.concurrent.Phaser;

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

Em Java SE 21, java.util.concurrent.Phaser é uma barreira reutilizável com um número variável de participantes. Phaser(int) começa na fase 0, sem barreira ascendente, com o número indicado de participantes já registados e ainda por chegar. Phaser() começa sem participantes. Um número negativo ou superior ao limite desta implementação, 65 535, provoca IllegalArgumentException.

register() regista um participante que ainda tem de assinalar a chegada e devolve a fase a que o registo se aplica. Se a barreira já tiver terminado, não altera nada e devolve um valor negativo. Tentar registar participantes acima do limite provoca IllegalStateException.

arriveAndAwaitAdvance() assinala a chegada e espera pela mudança de fase ou pelo fim da barreira, mantendo o registo. Uma interrupção, por si só, não acaba com a espera. Para uma espera interrompível ou com limite de tempo, separe arrive() da sobrecarga adequada de awaitAdvanceInterruptibly(...). arriveAndDeregister() assinala a chegada e retira o participante das fases seguintes sem esperar pelos outros. Devolve a fase de chegada ou um valor negativo se a barreira já tiver terminado.

A barreira mantém contadores, não regista a identidade das threads. Assinale uma só chegada por participante e por fase: uma chegada em falta pode bloquear os outros e uma chegada inválida não gera necessariamente uma exceção imediata. Quando o último participante cancela o registo, a implementação predefinida de onAdvance(int, int) termina a barreira no fecho da fase. Verifique esse estado com isTerminated().

Na fase 0, main usa o lugar reservado pelo construtor, regista três threads de trabalho antes de as iniciar e assinala a própria chegada com arrive(). Uma quarta thread regista-se na mesma fase antes de libertar as três primeiras através de um CompletableFuture. main não pode passar de awaitAdvance(...) até as quatro chegarem. Na fase 1, os cinco participantes assinalam a chegada e esperam; na fase 2, todos assinalam a chegada e cancelam o registo.

Exemplos

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

Resultado

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

Só `main` escreve na consola. Após a fase 0, ainda há cinco participantes registados, porque a fase 1 não pode terminar sem a chegada de `main`. A última linha é escrita depois de `join()` ter retornado para as quatro threads de trabalho.

Lições relacionadas

  • Java · Lição 35 · Avançado · Versão: 2

Fontes