CKTIS / Java
ThreadLocal — wartość przypisana do wątku
ThreadLocal przechowuje osobną wartość dla każdego wątku. Poznaj leniwą inicjalizację, odczyt, zapis i usuwanie wartości oraz znaczenie sprzątania po zadaniach wykonywanych w puli wątków.
Wersja: Java SE 21; repository runtime, production runtime not attested
Składnia
ThreadLocal<T> local = ThreadLocal.withInitial(() -> initialValue);
local.set(newValue);
T value = local.get();
local.remove();java.lang.ThreadLocal<T> wiąże wartość z bieżącym wątkiem, a nie z zadaniem. Wiele wątków może korzystać z jednego pola ThreadLocal, zachowując osobne wartości.
ThreadLocal.withInitial ustala dostawcę wartości początkowej. ThreadLocal.get inicjalizuje wartość przy pierwszym odczycie, chyba że wcześniej wykonano ThreadLocal.set. Wyrażenie new ThreadLocal<>() tworzy instancję. Pierwsze wywołanie get() na tej instancji zwraca null, jeśli wcześniej nie ustawiono wartości dla bieżącego wątku. ThreadLocal.set zmienia wyłącznie wartość bieżącego wątku.
ThreadLocal.remove usuwa wpis bieżącego wątku; kolejny get() ponownie inicjalizuje wartość, o ile wcześniej nie wykonano set(...). set(null) nie jest usunięciem wpisu.
W puli wątków pozostawiona wartość może trafić do kolejnego zadania i niepotrzebnie utrzymywać dane w pamięci. Usuwaj kontekst zadania w finally. Przykład pokazuje niezależne wartości i ponowną inicjalizację; join() zapewnia końcowy wydruk wątku głównego po wydrukach wątku roboczego.
Przykłady
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();
}
}
}Wynik
worker initial: unset worker set: worker worker reset: unset main: main
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.