Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / Java

Thread.join — Esperar que uma thread termine

Usa `Thread.join` para esperar que uma thread termine. Distingue as sobrecargas que confirmam o fim da execução e identifica quando podes ler o resultado.

Versão: Java SE 21

Sintaxe

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 é um método de instância de java.lang.Thread. Em worker.join(), a thread que faz a chamada espera que worker termine. join não inicia nem para a thread de trabalho. Chama primeiro start(); join() sem argumentos não tem limite de tempo.

join(long millis) recebe um limite em milissegundos e join(long millis, int nanos) permite acrescentar nanossegundos. Um valor negativo de millis ou um valor de nanos fora do intervalo de 0 a 999 999 provoca IllegalArgumentException. Se todos os argumentos fornecidos forem zero, não há limite de tempo. Ambas as sobrecargas devolvem void: o regresso de uma chamada com limite não confirma, por si só, que a thread terminou. Se a thread tiver sido iniciada, verificar depois isAlive() == false confirma que já terminou nesse momento. As três variantes void regressam de imediato se a thread não tiver sido iniciada.

join(java.time.Duration), disponível desde o Java 19, devolve true se a thread já terminou e false caso contrário. Uma duração igual a zero ou negativa permite verificar sem esperar. Se a thread não tiver sido iniciada, esta sobrecarga lança IllegalThreadStateException.

As ações da thread de trabalho precedem, segundo a relação happens-before, a deteção do seu fim por outra thread. Uma vez confirmado o fim da execução, a thread que fez a chamada pode ler o resultado mesmo num campo sem volatile, desde que não haja escritas concorrentes nesse campo. Se várias threads contribuírem para o resultado, espera por cada uma com join antes de o leres. join não elimina condições de corrida entre as threads nem prova que a tarefa foi executada sem erros.

Quando join lança InterruptedException, é limpo o estado de interrupção da thread que fez a chamada, não o da thread de trabalho. Propaga a exceção ou, se a capturares para sair da operação atual, repõe o estado com Thread.currentThread().interrupt(). Não interpretes a interrupção como confirmação de que a thread terminou.

Exemplos

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

Resultado

before = false
after = true
value = 42

O contador de sincronização impede que a thread de trabalho termine durante a primeira tentativa com limite, que devolve `false`. Quando o contador chega a zero, `join()` confirma o fim da execução: a segunda tentativa com limite devolve `true` e `main` lê `42`.

Lições relacionadas

  • Java · Lição 49 · Intermédio · Versão: 2
  • Java · Lição 52 · Intermédio · Versão: 2
  • Java · Lição 53 · Intermédio · Versão: 2
  • Java · Lição 58 · Intermédio · Versão: 2

Fontes