Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / Java

ThreadLocal : initialiser, écrire, lire et supprimer une valeur par thread

Une instance partagée de `ThreadLocal` conserve une valeur distincte par thread. La suppression permet à la lecture suivante de réinitialiser la valeur, sans créer de copie des objets.

Version : Java SE 21

Syntaxe

java.lang.ThreadLocal<T> (Java SE 21)

import java.util.function.Supplier;

// Method signatures:
public static <S> ThreadLocal<S> withInitial(Supplier<? extends S> supplier)
public void set(T value)
public T get()
public void remove()

Dans Java SE 21, plusieurs threads peuvent utiliser la même instance de java.lang.ThreadLocal<T>, mais chacun dispose de sa propre entrée pour cette instance. get(), set(T value) et remove() agissent uniquement sur l’entrée du thread appelant.

La méthode statique ThreadLocal.withInitial(supplier) crée l’instance sans appeler le fournisseur. Si get() ne trouve aucune entrée pour le thread courant, il appelle supplier.get(), stocke le résultat et le renvoie. set(value) stocke ou remplace la valeur sans appeler le fournisseur : un premier set avant toute lecture évite donc l’initialisation. set(null) stocke null sans supprimer l’entrée. Passer null comme fournisseur à withInitial déclenche une NullPointerException.

remove() supprime l’entrée sans la réinitialiser immédiatement. Le prochain get() sur le même thread rappelle le fournisseur, sauf si un set(...) a lieu entre-temps. Dans un pool de threads, une tâche ultérieure exécutée sur le même thread peut lire une valeur laissée par une autre tâche, et les données peuvent être conservées plus longtemps que nécessaire. Si une tâche est responsable de l’entrée, elle doit la supprimer avec remove() dans finally, sur ce même thread.

Les entrées sont distinctes, pas nécessairement les objets. Si le fournisseur renvoie le même objet mutable aux deux threads, ils le partagent toujours. ThreadLocal ne fait pas de copie profonde et ne synchronise pas l’accès à cet objet.

Exemples

public class Main {
    private static final ThreadLocal<String> LOCAL =
            ThreadLocal.withInitial(() -> "default");

    public static void main(String[] args) throws InterruptedException {
        LOCAL.set("main-value");
        try {
            Thread worker = new Thread(() -> {
                try {
                    System.out.println("worker first get: " + LOCAL.get());
                    LOCAL.set(null);
                    System.out.println("worker after set(null): " + LOCAL.get());
                    LOCAL.remove();
                    System.out.println("worker after remove: " + LOCAL.get());
                } finally {
                    LOCAL.remove();
                }
            });
            worker.start();
            worker.join();
            System.out.println("main after join: " + LOCAL.get());
        } finally {
            LOCAL.remove();
        }
    }
}

Résultat

worker first get: default
worker after set(null): null
worker after remove: default
main after join: main-value

Le thread de travail lit `default`, puis `null` après `set(null)`, puis de nouveau `default` après `remove()`. `join()` attend sa fin avant que le thread principal affiche sa valeur inchangée, `main-value`.

Leçons associées

  • Java · Leçon 33 · Avancé · Version : 2

Sources