CKTIS / Java
Thread.join — Čekání na ukončení vlákna
Pomocí `Thread.join` počkáte na ukončení vlákna. Zjistěte, které varianty toto ukončení potvrzují a kdy může volající bezpečně přečíst výsledek pracovního vlákna.
Verze: Java SE 21
Syntaxe
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 instanční metoda třídy java.lang.Thread. Při volání worker.join() čeká volající vlákno na ukončení vlákna worker. join pracovní vlákno nespouští ani nezastavuje. Nejprve zavolejte start(); join() bez argumentů nemá časový limit.
join(long millis) přijímá časový limit v milisekundách a join(long millis, int nanos) umožňuje přidat nanosekundy. Záporné millis nebo nanos mimo rozsah 0 až 999 999 způsobí IllegalArgumentException. Pokud jsou všechny předané argumenty nulové, čekání nemá časový limit. Obě varianty vracejí void: samotný návrat z volání s limitem ukončení nepotvrzuje. Pokud bylo vlákno spuštěno, následná kontrola isAlive() == false potvrdí, že v okamžiku kontroly už skončilo. Všechny tři varianty void se u nespuštěného vlákna vrátí okamžitě.
join(java.time.Duration) je k dispozici od Javy 19 a vrací true, pokud vlákno skončilo, jinak false. Při nulové nebo záporné době pouze zkontroluje stav bez čekání. U nespuštěného vlákna tato varianta vyvolá IllegalThreadStateException.
Akce pracovního vlákna předcházejí podle vztahu happens-before okamžiku, kdy jiné vlákno zjistí jeho ukončení. Jakmile je ukončení potvrzeno, může volající číst výsledek i z pole bez volatile, pokud do něj neprobíhají konfliktní zápisy. Pokud k výsledku přispívá více vláken, před jeho přečtením počkejte pomocí join na každé z nich. join neřeší souběhy mezi pracovními vlákny ani nezaručuje, že úloha proběhla bez chyby.
Pokud join vyvolá InterruptedException, vymaže se příznak přerušení volajícího vlákna, nikoli pracovního. Výjimku předejte dál, nebo pokud ji zachytíte, abyste ukončili aktuální operaci, obnovte příznak voláním Thread.currentThread().interrupt(). Přerušení není potvrzením ukončení pracovního vlákna.
Pří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ýsledek
before = false after = true value = 42
Synchronizační čítač brání pracovnímu vláknu skončit během prvního pokusu s limitem, který proto vrátí `false`. Po vynulování čítače `join()` potvrdí ukončení: druhý pokus s limitem vrátí `true` a `main` přečte `42`.
Související lekce
- Java · Lekce 49 · Středně pokročilá · Verze: 2
- Java · Lekce 52 · Středně pokročilá · Verze: 2
- Java · Lekce 53 · Středně pokročilá · Verze: 2
- Java · Lekce 58 · Středně pokročilá · Verze: 2