CKTIS / Java
Thread.join — Esperar a que termine un hilo
Usa `Thread.join` para esperar a que termine un hilo. Distingue qué sobrecargas confirman la terminación y cuándo puedes leer el resultado del hilo de trabajo.
Versión: Java SE 21
Sintaxis
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 es un método de instancia de java.lang.Thread. En worker.join(), el hilo que hace la llamada espera a que termine worker. join no inicia ni detiene el hilo de trabajo. Llama primero a start(); join() sin argumentos no tiene límite de tiempo.
join(long millis) recibe un límite en milisegundos, y join(long millis, int nanos) permite añadir nanosegundos. Un valor negativo de millis o un valor de nanos fuera del intervalo de 0 a 999 999 provoca IllegalArgumentException. Si todos los argumentos son cero, no hay límite. Ambas sobrecargas devuelven void: el retorno de una llamada con límite no confirma por sí solo la terminación. Si ya has iniciado el hilo, comprobar después que isAlive() == false confirma que ha terminado para entonces. Las tres variantes void retornan de inmediato si el hilo aún no se ha iniciado.
join(java.time.Duration), disponible desde Java 19, devuelve true si el hilo ha terminado y false si no lo ha hecho. Una duración de cero o negativa comprueba el estado sin esperar. Si el hilo aún no se ha iniciado, esta sobrecarga lanza IllegalThreadStateException.
Las acciones del hilo de trabajo preceden, según la relación happens-before, a la detección de su terminación por otro hilo. Una vez confirmada la terminación, el hilo que hizo la llamada puede leer el resultado incluso de un campo no volatile, siempre que no haya escrituras en conflicto. Si varios hilos contribuyen al resultado, espera a cada uno con join antes de leerlo. join no elimina las condiciones de carrera entre los hilos ni demuestra que la tarea se haya ejecutado sin errores.
Si join lanza InterruptedException, se borra el estado de interrupción del hilo que hizo la llamada, no el del hilo de trabajo. Propaga la excepción o, si la capturas para salir de la operación actual, restablece ese estado con Thread.currentThread().interrupt(). No interpretes la interrupción como confirmación de que el hilo ha terminado.
Ejemplos
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
El contador de sincronización impide que el hilo de trabajo termine durante el primer intento con límite, que devuelve `false`. Tras liberar el contador, `join()` confirma la terminación: el segundo intento con límite devuelve `true` y `main` lee `42`.
Lecciones relacionadas
- Java · Lección 49 · Intermedio · Versión: 2
- Java · Lección 52 · Intermedio · Versión: 2
- Java · Lección 53 · Intermedio · Versión: 2
- Java · Lección 58 · Intermedio · Versión: 2