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