CKTIS / Java
Thread.join — Attendre la fin d’un thread
Utilisez `Thread.join` pour attendre la fin d’un thread. Selon la surcharge, vérifiez si le thread s’est terminé avant de lire le résultat qu’il a produit.
Version : Java SE 21
Syntaxe
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 est une méthode d’instance de java.lang.Thread. Avec worker.join(), le thread appelant attend la fin de worker. join ne démarre ni n’arrête le thread de travail. Appelez d’abord start() ; join() sans argument n’impose aucun délai maximal.
join(long millis) prend un délai maximal en millisecondes, et join(long millis, int nanos) permet d’y ajouter des nanosecondes. Des millis négatives ou des nanos hors de l’intervalle de 0 à 999 999 provoquent une IllegalArgumentException. Si tous les arguments fournis valent zéro, l’attente n’a pas de limite. Les deux surcharges renvoient void : le simple retour d’un appel temporisé ne confirme pas la fin du thread. Si celui-ci a été démarré, vérifier ensuite isAlive() == false confirme qu’il est terminé au moment du test. Les trois variantes void reviennent immédiatement si le thread n’a pas été démarré.
Disponible depuis Java 19, join(java.time.Duration) renvoie true si le thread est terminé et false sinon. Une durée nulle ou négative déclenche un test sans attente. Cette surcharge lève IllegalThreadStateException si le thread n’a pas été démarré.
Les actions du thread de travail précèdent, au sens de la relation happens-before, la détection de sa fin par un autre thread. Une fois cette fin confirmée, l’appelant peut lire le résultat même dans un champ non volatile, en l’absence d’écritures concurrentes sur ce champ. Si plusieurs threads contribuent au résultat, attendez chacun d’eux avec join avant de le lire. join n’élimine pas les situations de concurrence entre ces threads et ne garantit pas que la tâche s’est déroulée sans erreur.
Lorsque join lève InterruptedException, le statut d’interruption du thread appelant est effacé, pas celui du thread de travail. Propagez l’exception ou, si vous l’interceptez pour quitter l’opération en cours, rétablissez le statut avec Thread.currentThread().interrupt(). Une interruption ne confirme pas la fin du thread.
Exemples
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);
}
}Résultat
before = false after = true value = 42
Le verrou de synchronisation empêche le thread de travail de se terminer pendant le premier appel temporisé, qui renvoie donc `false`. Après la libération du verrou, `join()` confirme la fin du thread : le second appel temporisé renvoie `true` et `main` lit `42`.
Leçons associées
- Java · Leçon 49 · Intermédiaire · Version : 2
- Java · Leçon 52 · Intermédiaire · Version : 2
- Java · Leçon 53 · Intermédiaire · Version : 2
- Java · Leçon 58 · Intermédiaire · Version : 2