KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / Java

Thread.join — Wachten tot een thread stopt

Gebruik `Thread.join` om te wachten tot een thread is afgelopen. Leer welke overloads dat bevestigen en wanneer je het resultaat van de workerthread kunt lezen.

Versie: 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 InterruptedException

Thread.join is een instantiemethode van java.lang.Thread. Bij worker.join() wacht de aanroepende thread tot worker klaar is. join start of stopt de workerthread niet. Roep eerst start() aan; join() zonder argumenten heeft geen tijdslimiet.

join(long millis) gebruikt een tijdslimiet in milliseconden. Met join(long millis, int nanos) kun je daar nanoseconden aan toevoegen. Negatieve millis of nanos buiten het bereik van 0 tot en met 999.999 leiden tot IllegalArgumentException. Zijn alle opgegeven argumenten nul, dan geldt er geen tijdslimiet. Beide overloads retourneren void: het einde van een aanroep met tijdslimiet bewijst op zichzelf niet dat de thread is afgelopen. Is de thread gestart, dan bevestigt een controle op isAlive() == false na de aanroep dat de thread op dat moment is afgelopen. Alle drie de void-varianten keren direct terug voor een thread die niet is gestart.

join(java.time.Duration) is beschikbaar sinds Java 19 en retourneert true als de thread is afgelopen of false als dat nog niet zo is. Bij een duur van nul of minder controleert de methode zonder te wachten. Voor een niet-gestarte thread werpt deze overload IllegalThreadStateException.

De acties van de workerthread gaan volgens de happens-before-relatie vooraf aan het moment waarop een andere thread vaststelt dat de workerthread is afgelopen. Na die bevestiging kan de aanroeper het resultaat ook uit een veld zonder volatile lezen, zolang er geen conflicterende schrijfacties zijn. Dragen meerdere workerthreads bij aan het resultaat, wacht dan met join op elk van hen voordat je het leest. join voorkomt geen racecondities tussen workerthreads en bewijst niet dat de taak zonder fouten is uitgevoerd.

Als join een InterruptedException werpt, wordt de interruptstatus van de aanroepende thread gewist, niet die van de workerthread. Geef de exceptie door of herstel de status met Thread.currentThread().interrupt() als je de exceptie opvangt om de huidige bewerking af te breken. Beschouw een interrupt niet als bevestiging dat de workerthread is afgelopen.

Voorbeelden

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);
    }
}

Resultaat

before = false
after = true
value = 42

De synchronisatieteller voorkomt dat de workerthread tijdens de eerste poging met tijdslimiet eindigt, dus die aanroep retourneert `false`. Zodra de teller op nul staat, bevestigt `join()` dat de thread is afgelopen: de tweede poging retourneert `true` en `main` leest `42`.

Gerelateerde lessen

  • Java · Les 49 · Gemiddeld · Versie: 2
  • Java · Les 52 · Gemiddeld · Versie: 2
  • Java · Les 53 · Gemiddeld · Versie: 2
  • Java · Les 58 · Gemiddeld · Versie: 2

Bronnen