WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Java

ThreadLocal – ein einem Thread zugeordneter Wert

ThreadLocal speichert für jeden Thread einen eigenen Wert. Erfahre mehr über verzögerte Initialisierung, Lesen, Schreiben und Entfernen sowie darüber, warum die Bereinigung bei Aufgaben in einem Thread-Pool wichtig ist.

Version: 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> ordnet einen Wert dem aktuellen Thread zu, nicht einer Aufgabe. Mehrere Threads können dasselbe ThreadLocal-Feld verwenden und dabei jeweils eigene Werte behalten.

ThreadLocal.withInitial legt einen Lieferanten für den Anfangswert fest. ThreadLocal.get initialisiert den Wert beim ersten Zugriff, sofern nicht zuvor ThreadLocal.set aufgerufen wurde. Ein einfaches new ThreadLocal<>() erzeugt eine Instanz. Der erste Aufruf von get() auf dieser Instanz liefert null, wenn für den aktuellen Thread noch kein Wert gesetzt wurde. ThreadLocal.set ändert nur den Wert des aktuellen Threads.

ThreadLocal.remove löscht den Eintrag des aktuellen Threads; beim nächsten get() wird der Wert erneut initialisiert, sofern nicht vorher set(...) aufgerufen wird. set(null) entfernt den Eintrag nicht.

In einem Thread-Pool kann ein zurückgelassener Wert zur nächsten Aufgabe gelangen und Daten unnötig lange im Speicher halten. Entferne den Aufgabenkontext in finally. Das Beispiel zeigt unabhängige Werte und die erneute Initialisierung; join() stellt sicher, dass die abschließende Ausgabe des Haupt-Threads nach der Ausgabe des Worker-Threads erfolgt.

Beispiele

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

Ergebnis

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

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen