CKTIS / Java
Thread.join — Čekanje na završetak dretve
Upotrijebi `Thread.join` za čekanje na završetak dretve. Razlikuj inačice koje potvrđuju završetak i saznaj kada je sigurno pročitati rezultat radne dretve.
Verzija: Java SE 21
Sintaksa
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 metoda instance klase java.lang.Thread. Pri pozivu worker.join() pozivajuća dretva čeka da dretva worker završi. join ne pokreće niti zaustavlja radnu dretvu. Prvo pozovi start(); join() bez argumenata nema vremensko ograničenje.
join(long millis) prima vremensko ograničenje u milisekundama, a join(long millis, int nanos) omogućuje dodavanje nanosekundi. Negativan millis ili nanos izvan raspona od 0 do 999 999 uzrokuje IllegalArgumentException. Ako su svi zadani argumenti nula, čekanje nije vremenski ograničeno. Obje inačice vraćaju void: sam povratak iz poziva s vremenskim ograničenjem ne potvrđuje završetak. Ako je dretva pokrenuta, provjera isAlive() == false nakon poziva potvrđuje da je do tog trenutka završila. Sve tri inačice void odmah se vraćaju za dretvu koja nije pokrenuta.
join(java.time.Duration), dostupan od Jave 19, vraća true ako je dretva završila, odnosno false ako nije. Ako je trajanje nula ili negativno, metoda provjerava stanje bez čekanja. Za nepokrenutu dretvu ova inačica baca IllegalThreadStateException.
Radnje radne dretve prethode, prema odnosu happens-before, trenutku u kojem druga dretva utvrdi da je radna dretva završila. Nakon potvrde završetka pozivajuća dretva može pročitati rezultat čak i iz polja bez volatile, pod uvjetom da nema sukobljenih upisa. Ako više dretvi pridonosi rezultatu, prije čitanja pričekaj svaku pomoću join. join ne uklanja uvjete utrke među radnim dretvama i ne dokazuje da je zadatak izvršen bez pogreške.
Ako join baci InterruptedException, briše se status prekida pozivajuće dretve, a ne radne. Proslijedi iznimku ili, ako je uhvatiš radi izlaska iz trenutne operacije, obnovi status pozivom Thread.currentThread().interrupt(). Prekid nije potvrda da je radna dretva završila.
Primjeri
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);
}
}Rezultat
before = false after = true value = 42
Sinkronizacijsko brojilo sprječava radnu dretvu da završi tijekom prvog vremenski ograničenog pokušaja, koji zato vraća `false`. Kad brojilo dosegne nulu, `join()` potvrđuje završetak: drugi vremenski ograničeni pokušaj vraća `true`, a `main` čita `42`.
Povezane lekcije
- Java · Lekcija 49 · Srednje · Verzija: 2
- Java · Lekcija 52 · Srednje · Verzija: 2
- Java · Lekcija 53 · Srednje · Verzija: 2
- Java · Lekcija 58 · Srednje · Verzija: 2