CKTIS / Java
Phaser: регистриране, изчакване на следваща фаза и отписване
Използвайте `Phaser`, за да синхронизирате задачи в последователни фази, да добавите участник по време на фаза и да прекратите бариерата, когато последният участник се отпише.
Версия: Java SE 21
Синтаксис
import java.util.concurrent.Phaser;
Phaser phaser = new Phaser(1); // Signature: Phaser(int parties)
int registrationPhase = phaser.register();
phaser.arriveAndAwaitAdvance();
int arrivalPhase = phaser.arriveAndDeregister();java.util.concurrent.Phaser в Java SE 21 е многократно използваема бариера с променлив брой участници. Phaser(int) започва във фаза 0 без родителска бариера и с указания брой вече регистрирани участници, които още не са отчели пристигане. Phaser() започва без участници. Отрицателен брой или стойност над ограничението на тази реализация (65 535) предизвиква IllegalArgumentException.
register() добавя един участник, който още трябва да отчете пристигане, и връща фазата, за която важи регистрацията. След прекратяване на бариерата не променя нищо и връща отрицателна стойност. Опит за надхвърляне на допустимия брой участници чрез регистрация предизвиква IllegalStateException.
arriveAndAwaitAdvance() отчита пристигане и изчаква преминаване към следващата фаза или прекратяване на бариерата, без да отписва участника. Самото прекъсване на нишката не прекратява чакането. За прекъсваемо чакане или ограничение във времето използвайте отделни извиквания на arrive() и подходящия претоварен вариант на awaitAdvanceInterruptibly(...). arriveAndDeregister() отчита пристигане и отписва участника от бъдещите фази, без да чака останалите. Връща фазата на пристигане или отрицателна стойност, ако бариерата вече е прекратена.
Бариерата следи броячи, а не самоличността на нишките. Отчитайте по едно пристигане за всеки участник във всяка фаза: пропуснатото пристигане може да блокира останалите, а неправилното не води непременно до незабавно изключение. При отписването на последния участник стандартният onAdvance(int, int) прекратява бариерата в края на фазата. Проверете състоянието с isTerminated().
Във фаза 0 main използва мястото от конструктора, регистрира три работни нишки преди стартирането им и отчита собственото си пристигане с arrive(). Четвърта нишка се регистрира в същата фаза, преди да освободи първите три чрез CompletableFuture. main не може да продължи след awaitAdvance(...), докато и четирите нишки не пристигнат. Във фаза 1 петимата участници отчитат пристигане и чакат, а във фаза 2 всички отчитат пристигане и се отписват.
Примери
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());
}
}Резултат
Phase 0 complete: 5 registered Phase 1 complete Phase 2 complete: terminated = true
Само `main` извежда съобщения. След фаза 0 все още има петима регистрирани участници, тъй като фаза 1 не може да завърши без пристигането на `main`. Последният ред се извежда, след като `join()` се върне за всяка от четирите работни нишки.
Свързани уроци
- Java · Урок 35 · Напреднало · Версия: 2