CKTIS / Java
ThreadLocal — une valeur associée à un thread
ThreadLocal stocke une valeur distincte pour chaque thread. Découvrez l’initialisation différée, la lecture, l’écriture et la suppression, ainsi que l’importance du nettoyage pour les tâches exécutées dans un pool de threads.
Version : Java SE 21; repository runtime, production runtime not attested
Syntaxe
ThreadLocal<T> local = ThreadLocal.withInitial(() -> initialValue);
local.set(newValue);
T value = local.get();
local.remove();java.lang.ThreadLocal<T> associe une valeur au thread courant, et non à une tâche. Plusieurs threads peuvent utiliser un même champ ThreadLocal tout en conservant chacun leur propre valeur.
ThreadLocal.withInitial fournit un initialiseur. ThreadLocal.get initialise la valeur lors du premier accès, sauf si ThreadLocal.set a été appelé auparavant. Un simple new ThreadLocal<>() crée une instance. Le premier appel à get() sur cette instance renvoie null si aucune valeur n’a été définie pour le thread courant. ThreadLocal.set ne modifie que la valeur du thread courant.
ThreadLocal.remove supprime l’entrée du thread courant ; le prochain get() l’initialise à nouveau, sauf si set(...) intervient entre-temps. set(null) ne supprime pas l’entrée.
Dans un pool de threads, une valeur oubliée peut être transmise à la tâche suivante et conserver inutilement des données en mémoire. Supprimez le contexte de la tâche dans finally. L’exemple montre des valeurs indépendantes et leur réinitialisation ; join() garantit que l’affichage final du thread principal suit celui du thread de travail.
Exemples
public class ThreadLocalDemo {
private static final ThreadLocal<String> CONTEXT =
ThreadLocal.withInitial(() -> "unset");
public static void main(String[] args) throws InterruptedException {
try {
CONTEXT.set("main");
Thread worker = new Thread(() -> {
try {
System.out.println("worker initial: " + CONTEXT.get());
CONTEXT.set("worker");
System.out.println("worker set: " + CONTEXT.get());
} finally {
CONTEXT.remove();
}
try {
System.out.println("worker reset: " + CONTEXT.get());
} finally {
CONTEXT.remove();
}
});
worker.start();
worker.join();
System.out.println("main: " + CONTEXT.get());
} finally {
CONTEXT.remove();
}
}
}Résultat
worker initial: unset worker set: worker worker reset: unset main: main
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.