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

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.

Fontes