KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / Java

ThreadLocal — een waarde gekoppeld aan een thread

ThreadLocal slaat voor elke thread een aparte waarde op. Lees meer over luie initialisatie, lezen, schrijven en verwijderen, en waarom opruimen belangrijk is voor taken in een threadpool.

Versie: Java SE 21; repository runtime, production runtime not attested

Syntax

ThreadLocal<T> local = ThreadLocal.withInitial(() -> initialValue);
local.set(newValue);
T value = local.get();
local.remove();

java.lang.ThreadLocal<T> koppelt een waarde aan de huidige thread, niet aan een taak. Meerdere threads kunnen hetzelfde ThreadLocal-veld gebruiken en toch elk hun eigen waarde behouden.

ThreadLocal.withInitial levert een initialisatiefunctie. ThreadLocal.get initialiseert de waarde bij het eerste gebruik, tenzij eerder ThreadLocal.set is aangeroepen. De expressie new ThreadLocal<>() maakt een instantie aan. De eerste aanroep van get() op die instantie geeft null terug als er voor de huidige thread nog geen waarde is ingesteld. ThreadLocal.set wijzigt alleen de waarde van de huidige thread.

ThreadLocal.remove verwijdert de vermelding van de huidige thread; bij de volgende get() wordt de waarde opnieuw geïnitialiseerd, tenzij tussendoor set(...) wordt aangeroepen. set(null) verwijdert de vermelding niet.

In een threadpool kan een achtergebleven waarde bij de volgende taak terechtkomen en gegevens onnodig in het geheugen houden. Verwijder de taakcontext in finally. Het voorbeeld laat onafhankelijke waarden en herinitialisatie zien; join() zorgt ervoor dat de uiteindelijke uitvoer van de hoofdthread na die van de workerthread verschijnt.

Voorbeelden

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

Resultaat

worker initial: unset
worker set: worker
worker reset: unset
main: main

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen