CKTIS / Java
Phaser — sincronização de etapas de trabalho
Phaser é uma barreira de sincronização reutilizável com um número variável de participantes. Permite que as tarefas aguardem pelo fim de uma etapa e se desregistem quando terminam o trabalho.
Versão: Java SE 21; repository runtime, production runtime not attested
Sintaxe
Phaser phaser = new Phaser();
phaser.register();
phaser.arriveAndAwaitAdvance();
phaser.arriveAndDeregister();Phaser coordena fases de trabalho sucessivas. Phaser.register() adiciona um participante que ainda não chegou. O registo altera os contadores, mas não associa um participante a uma thread específica.
Phaser.arriveAndAwaitAdvance() assinala a chegada e aguarda pela mudança de fase. Phaser.arriveAndDeregister() assinala a chegada e remove o participante sem aguardar. Por predefinição, a remoção do último participante termina a barreira.
No exemplo, new Phaser(1) tem em conta a thread principal; o registo adicional ocorre antes de iniciar worker. Duas fases separam os cálculos. A relação happens-before garante que o resultado fica visível após a segunda barreira.
A falta de uma chegada pode bloquear os restantes participantes. arriveAndAwaitAdvance() não deixa de aguardar devido a uma interrupção; para uma espera interrompível, use awaitAdvanceInterruptibly(...) após arrive().
Exemplos
import java.util.concurrent.Phaser;
public class PhaserExample {
public static void main(String[] args) throws InterruptedException {
Phaser phaser = new Phaser(1);
int[] result = {0};
phaser.register();
Thread worker = new Thread(() -> {
result[0] = 21;
phaser.arriveAndAwaitAdvance();
result[0] *= 2;
phaser.arriveAndDeregister();
});
worker.start();
phaser.arriveAndAwaitAdvance();
phaser.arriveAndAwaitAdvance();
System.out.println("result=" + result[0]);
phaser.arriveAndDeregister();
worker.join();
System.out.println("terminated=" + phaser.isTerminated());
}
}Resultado
result=42 terminated=true
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.