CKTIS / Java
Phaser: registrar, esperar el cambio de fase y dar de baja
Usa `Phaser` para sincronizar tareas en varias fases, incorporar un participante durante una fase activa y terminar la barrera cuando se retire el último participante.
Versión: Java SE 21
Sintaxis
import java.util.concurrent.Phaser;
Phaser phaser = new Phaser(1); // Signature: Phaser(int parties)
int registrationPhase = phaser.register();
phaser.arriveAndAwaitAdvance();
int arrivalPhase = phaser.arriveAndDeregister();En Java SE 21, java.util.concurrent.Phaser es una barrera reutilizable con un número variable de participantes. Phaser(int) empieza en la fase 0, sin barrera padre, con el número indicado de participantes ya registrados y pendientes de llegar. Phaser() empieza sin participantes. Un número negativo o superior al límite de esta implementación, 65 535, provoca IllegalArgumentException.
register() registra un participante que todavía debe señalar su llegada y devuelve la fase a la que se aplica el registro. Una vez terminada la barrera, no cambia nada y devuelve un valor negativo. Intentar superar el límite de participantes mediante un registro provoca IllegalStateException.
arriveAndAwaitAdvance() señala la llegada y espera a que cambie la fase o termine la barrera, sin dar de baja al participante. Una interrupción por sí sola no pone fin a la espera. Para que la espera sea interrumpible o tenga un límite de tiempo, separa arrive() de la sobrecarga adecuada de awaitAdvanceInterruptibly(...). arriveAndDeregister() señala la llegada y da de baja al participante para fases futuras sin esperar a los demás. Devuelve la fase de llegada o un valor negativo si la barrera ya había terminado.
La barrera mantiene contadores, no identidades de hilos. Señala una sola llegada por participante y fase: si falta una, los demás pueden quedar bloqueados; una llegada incorrecta no tiene por qué provocar una excepción de inmediato. Cuando se da de baja el último participante, el onAdvance(int, int) predeterminado termina la barrera al cerrar la fase. Comprueba ese estado con isTerminated().
En la fase 0, main usa la plaza del constructor, registra tres hilos de trabajo antes de iniciarlos y señala su propia llegada con arrive(). Un cuarto hilo se registra en esa misma fase antes de liberar a los tres primeros mediante un CompletableFuture. main no puede salir de awaitAdvance(...) hasta que lleguen los cuatro. En la fase 1, los cinco señalan su llegada y esperan; en la fase 2, los cinco señalan su llegada y se dan de baja.
Ejemplos
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
Solo `main` imprime mensajes. Después de la fase 0 siguen registrados cinco participantes porque la fase 1 no puede acabar sin la llegada de `main`. La última línea se imprime cuando `join()` ha retornado para los cuatro hilos de trabajo.
Lecciones relacionadas
- Java · Lección 35 · Avanzado · Versión: 2