CKTIS / Java
Thread.join — Čakanie na ukončenie vlákna
Pomocou `Thread.join` počkáš na ukončenie vlákna. Zisti, ktoré varianty toto ukončenie potvrdzujú a kedy môže volajúce vlákno bezpečne prečítať výsledok.
Verzia: Java SE 21
Syntax
public final void join() throws InterruptedException
public final void join(long millis) throws InterruptedException
public final void join(long millis, int nanos) throws InterruptedException
public final boolean join(java.time.Duration duration) throws InterruptedExceptionThread.join je inštančná metóda triedy java.lang.Thread. Pri volaní worker.join() čaká volajúce vlákno na ukončenie vlákna worker. join pracovné vlákno nespúšťa ani nezastavuje. Najprv zavolaj start(); join() bez argumentov nemá časový limit.
join(long millis) prijíma časový limit v milisekundách a join(long millis, int nanos) umožňuje pridať nanosekundy. Záporné millis alebo nanos mimo rozsahu od 0 do 999 999 spôsobia IllegalArgumentException. Ak sú všetky zadané argumenty nulové, čakanie nemá časový limit. Oba varianty vracajú void: samotný návrat z volania s limitom nepotvrdzuje ukončenie. Ak bolo vlákno spustené, následná kontrola isAlive() == false potvrdí, že v čase kontroly už skončilo. Všetky tri varianty void sa pri nespustenom vlákne vrátia okamžite.
join(java.time.Duration) je k dispozícii od Javy 19 a vráti true, ak vlákno skončilo, inak false. Pri nulovom alebo zápornom trvaní skontroluje stav bez čakania. Pri nespustenom vlákne tento variant vyvolá IllegalThreadStateException.
Akcie pracovného vlákna predchádzajú podľa vzťahu happens-before okamihu, keď iné vlákno zistí jeho ukončenie. Po potvrdení ukončenia môže volajúce vlákno prečítať výsledok aj z poľa bez volatile, ak nedochádza ku konfliktným zápisom. Ak k výsledku prispieva viac vlákien, pred jeho čítaním počkaj pomocou join na každé z nich. join neodstraňuje súbehy medzi pracovnými vláknami ani nepotvrdzuje, že úloha prebehla bez chyby.
Keď join vyvolá InterruptedException, príznak prerušenia sa vymaže volajúcemu vláknu, nie pracovnému. Výnimku odovzdaj ďalej alebo, ak ju zachytíš s cieľom ukončiť aktuálnu operáciu, obnov príznak pomocou Thread.currentThread().interrupt(). Prerušenie nepotvrdzuje ukončenie pracovného vlákna.
Príklady
import java.time.Duration;
import java.util.concurrent.CountDownLatch;
public class JoinDemo {
static final class Result {
int value;
}
public static void main(String[] args) throws InterruptedException {
Result result = new Result();
CountDownLatch release = new CountDownLatch(1);
Thread worker = new Thread(() -> {
try {
release.await();
result.value = 42;
} catch (InterruptedException e) {
Thread.currentThread().interrupt();
}
});
Duration timeout = Duration.ofMillis(10);
worker.start();
boolean before;
try {
before = worker.join(timeout);
} finally {
release.countDown();
}
worker.join();
boolean after = worker.join(timeout);
System.out.println("before = " + before);
System.out.println("after = " + after);
System.out.println("value = " + result.value);
}
}Výsledok
before = false after = true value = 42
Synchronizačné počítadlo bráni pracovnému vláknu skončiť počas prvého pokusu s limitom, preto tento pokus vráti `false`. Po vynulovaní počítadla `join()` potvrdí ukončenie: druhý pokus s limitom vráti `true` a `main` prečíta `42`.
Súvisiace lekcie
- Java · Lekcia 49 · Stredne pokročilá · Verzia: 2
- Java · Lekcia 52 · Stredne pokročilá · Verzia: 2
- Java · Lekcia 53 · Stredne pokročilá · Verzia: 2
- Java · Lekcia 58 · Stredne pokročilá · Verzia: 2