Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

Thread.join — oczekiwanie na zakończenie wątku

Za pomocą `Thread.join` poczekaj na zakończenie wątku. Sprawdź, czy wybrany wariant potwierdza zakończenie i kiedy można odczytać dane zapisane przez ten wątek.

Wersja: Java SE 21

Składnia

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 to metoda instancji klasy java.lang.Thread. W wywołaniu worker.join() czeka wątek wywołujący, a worker jest wątkiem, którego zakończenie ma nastąpić. join nie uruchamia ani nie zatrzymuje wątku roboczego. Najpierw wywołaj start(); bezargumentowe join() nie ma limitu czasu.

join(long millis) przyjmuje limit w milisekundach, a join(long millis, int nanos) pozwala dodać nanosekundy. Ujemne millis lub nanos spoza zakresu od 0 do 999 999 powodują IllegalArgumentException. Gdy wszystkie przekazane argumenty są zerami, nie ma limitu czasu. Oba warianty zwracają void: powrót z wywołania z limitem sam w sobie nie potwierdza zakończenia. Jeśli wątek został uruchomiony, isAlive() == false po takim wywołaniu potwierdza, że wątek już się zakończył. Wszystkie trzy warianty void natychmiast wracają dla wątku, którego nie uruchomiono.

Dostępne od Javy 19 join(java.time.Duration) zwraca true, gdy wątek się zakończył, albo false, gdy jeszcze się nie zakończył. Czas zerowy lub ujemny oznacza sprawdzenie bez czekania. Dla wątku, którego nie uruchomiono, metoda zgłasza IllegalThreadStateException.

Działania wątku roboczego poprzedzają (happen-before) wykrycie jego zakończenia przez inny wątek. Dlatego po potwierdzeniu zakończenia można odczytać zapisany przez niego wynik nawet z pola bez volatile, o ile nie ma z nim kolidujących zapisów. Gdy na wynik składa się praca kilku wątków, zaczekaj na zakończenie każdego z nich przed odczytem. join nie usuwa wyścigów między wątkami i nie potwierdza, że zadanie zakończyło się bez błędu.

Przerwanie oczekiwania przez zgłoszenie InterruptedException czyści znacznik przerwania wątku wywołującego, a nie roboczego. Przekaż wyjątek dalej albo, jeśli go przechwytujesz, żeby zakończyć bieżącą operację, przywróć znacznik przez Thread.currentThread().interrupt(). Nie traktuj przerwania jako potwierdzenia zakończenia.

Przykłady

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

Wynik

before = false
after = true
value = 42

Zatrzask nie pozwala wątkowi roboczemu zakończyć się podczas pierwszej próby z limitem, więc zwraca ona `false`. Po zwolnieniu zatrzasku `join()` potwierdza zakończenie: druga próba z limitem zwraca `true`, a `main` odczytuje `42`.

Powiązane lekcje

  • Java · Lekcja 49 · Średniozaawansowany · Wersja: 2
  • Java · Lekcja 52 · Średniozaawansowany · Wersja: 2
  • Java · Lekcja 53 · Średniozaawansowany · Wersja: 2
  • Java · Lekcja 58 · Średniozaawansowany · Wersja: 2

Źródła