CKTIS / Java
ThreadLocal: Werte pro Thread initialisieren, setzen, lesen und entfernen
Eine gemeinsam genutzte `ThreadLocal`-Instanz hält für jeden Thread einen eigenen Wert. Nach dem Entfernen kann der nächste Lesezugriff den Wert neu initialisieren; Objekte werden dabei nicht kopiert.
Version: Java SE 21
Syntax
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()In Java SE 21 können mehrere Threads dieselbe Instanz von java.lang.ThreadLocal<T> nutzen. Jeder Thread hat dafür einen eigenen Eintrag. get(), set(T value) und remove() wirken nur auf den Eintrag des aufrufenden Threads.
Die statische Methode ThreadLocal.withInitial(supplier) erzeugt die Instanz, ohne den Supplier aufzurufen. Findet get() für den aktuellen Thread keinen Eintrag, ruft es supplier.get() auf, speichert das Ergebnis und gibt es zurück. set(value) speichert oder ersetzt den Wert ohne Supplier-Aufruf. Erfolgt das Setzen vor dem ersten Lesen, entfällt die Initialisierung. set(null) speichert null; der Eintrag bleibt bestehen. Ein null-Supplier bei withInitial führt zu einer NullPointerException.
remove() löscht den Eintrag, ohne ihn sofort neu zu initialisieren. Das nächste get() im selben Thread ruft den Supplier erneut auf, sofern dazwischen kein set(...) erfolgt. In einem Threadpool kann eine spätere Aufgabe auf demselben Worker einen zurückgelassenen Wert lesen; außerdem können Daten länger als nötig erhalten bleiben. Ist eine Aufgabe für den Eintrag verantwortlich, sollte sie ihn mit remove() in finally auf demselben Worker entfernen.
Getrennt sind die Einträge, nicht unbedingt die Objekte. Liefert der Supplier beiden Threads dasselbe veränderliche Objekt, teilen sie es weiterhin. ThreadLocal erstellt keine tiefe Kopie und synchronisiert den Zugriff auf das Objekt nicht.
Beispiele
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();
}
}
}Ergebnis
worker first get: default worker after set(null): null worker after remove: default main after join: main-value
Der Worker liest `default`, nach `set(null)` dann `null` und nach `remove()` wieder `default`. `join()` wartet auf sein Ende. Erst danach gibt der Hauptthread seinen unveränderten Wert `main-value` aus.
Zugehörige Lektionen
- Java · Lektion 33 · Fortgeschritten · Version: 2