WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Java

Thread.join — Auf das Ende eines Threads warten

Mit `Thread.join` wartest du auf das Ende eines Threads. Entscheidend ist, welche Überladung das Ende bestätigt und ab wann das Ergebnis des Worker-Threads sichtbar ist.

Version: 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 ist eine Instanzmethode von java.lang.Thread. Bei worker.join() wartet der aufrufende Thread darauf, dass worker endet. join startet oder stoppt den Worker-Thread nicht. Rufe zuerst start() auf; join() ohne Argumente hat kein Zeitlimit.

join(long millis) erwartet ein Zeitlimit in Millisekunden, bei join(long millis, int nanos) kommen Nanosekunden hinzu. Negative millis oder nanos außerhalb des Bereichs von 0 bis 999 999 führen zu einer IllegalArgumentException. Sind alle übergebenen Argumente null, gibt es kein Zeitlimit. Beide Überladungen liefern void: Die Rückkehr aus einem Aufruf mit Zeitlimit bestätigt das Ende nicht. Wurde der Thread gestartet, bestätigt die anschließende Prüfung isAlive() == false, dass er zu diesem Zeitpunkt beendet ist. Bei einem nicht gestarteten Thread kehren alle drei void-Varianten sofort zurück.

join(java.time.Duration) gibt es seit Java 19. Die Methode liefert true, wenn der Thread beendet ist, andernfalls false. Bei einer Dauer von null oder weniger prüft sie ohne zu warten. Wurde der Thread nicht gestartet, löst diese Überladung eine IllegalThreadStateException aus.

Die Aktionen des Worker-Threads liegen in der Happens-before-Ordnung vor dem Erkennen seines Endes durch einen anderen Thread. Sobald das Ende bestätigt ist, kann der Aufrufer das Ergebnis auch aus einem Feld ohne volatile lesen, sofern es keine konkurrierenden Schreibzugriffe darauf gibt. Tragen mehrere Threads zum Ergebnis bei, warte vor dem Lesen mit join auf jeden von ihnen. join verhindert keine Wettlaufsituationen zwischen Worker-Threads und bestätigt keinen fehlerfreien Aufgabenablauf.

Wenn join eine InterruptedException auslöst, wird der Interrupt-Status des aufrufenden Threads gelöscht, nicht der des Worker-Threads. Gib die Ausnahme weiter oder stelle den Status mit Thread.currentThread().interrupt() wieder her, wenn du die Ausnahme abfängst, um den aktuellen Vorgang abzubrechen. Eine Unterbrechung bestätigt nicht das Ende des Worker-Threads.

Beispiele

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

Ergebnis

before = false
after = true
value = 42

Die Sperre verhindert, dass der Worker-Thread während des ersten Aufrufs mit Zeitlimit endet. Der Aufruf liefert daher `false`. Nach der Freigabe bestätigt `join()` das Ende: Der zweite Aufruf mit Zeitlimit liefert `true`, und `main` liest `42`.

Zugehörige Lektionen

  • Java · Lektion 49 · Mittlere Stufe · Version: 2
  • Java · Lektion 52 · Mittlere Stufe · Version: 2
  • Java · Lektion 53 · Mittlere Stufe · Version: 2
  • Java · Lektion 58 · Mittlere Stufe · Version: 2

Quellen