CKTIS / Java
InheritableThreadLocal — dziedziczenie wartości lokalnych wątku
InheritableThreadLocal<T> przekazuje początkową wartość z wątku rodzica do nowo tworzonego wątku potomnego. Dziedziczenie zachodzi przy tworzeniu wątku, nie przy start() ani przy przekazaniu zadania do puli.
Wersja: Java SE 21; repository runtime, production runtime not attested
Składnia
InheritableThreadLocal<T> context = new InheritableThreadLocal<>();
context.set(value);
T current = context.get();
context.remove();
// Optional override: protected T childValue(T parentValue)InheritableThreadLocal<T> z pakietu java.lang rozszerza ThreadLocal<T>. Zwykły ThreadLocal inicjalizuje wartość niezależnie dla każdego wątku; jego podklasa pozwala potomkowi odziedziczyć wartość rodzica. get(), set() i remove() dotyczą wartości bieżącego wątku; bez ustawienia lub odziedziczenia domyślna wartość początkowa to null.
Wartość potomka jest ustalana podczas tworzenia obiektu Thread, nie przy start(). Metoda protected T childValue(T parentValue) wykonuje się w rodzicu przed uruchomieniem potomka; można ją nadpisać. Domyślnie zwraca przekazany argument: dla obiektów oznacza to tę samą referencję, a nie głęboką kopię. Późniejsze set() w jednym wątku nie zmienia przypisania w drugim, ale mutowalny obiekt może być współdzielony i wymagać synchronizacji.
W Java SE 21 można wyłączyć dziedziczenie przez inheritInheritableThreadLocals(false) w Thread.Builder; domyślnie jest włączone. Z momentu dziedziczenia wynika ważne ograniczenie: istniejący wątek roboczy puli nie otrzymuje kontekstu na nowo przy każdym zadaniu. Nie używaj tego mechanizmu jako automatycznego przekazywania kontekstu żądań do puli. Usuwaj wartości przez remove() w finally; usuwa to wartość tylko bieżącego wątku.
Przykład używa niemutowalnego String: rodzic zmienia wartość po utworzeniu potomka, ale przed start(). Potomek nadal odczytuje at-creation, a jego własne set() nie zastępuje wartości rodzica. join() zapewnia zakończenie potomka przed wypisaniem wiersza rodzica.
Przykłady
public class Main {
private static final InheritableThreadLocal<String> CONTEXT =
new InheritableThreadLocal<>();
public static void main(String[] args) throws InterruptedException {
CONTEXT.set("at-creation");
try {
Thread child = new Thread(() -> {
try {
System.out.println("child: " + CONTEXT.get());
CONTEXT.set("child-only");
} finally {
CONTEXT.remove();
}
});
CONTEXT.set("after-creation");
child.start();
child.join();
System.out.println("parent: " + CONTEXT.get());
} finally {
CONTEXT.remove();
}
}
}Wynik
child: at-creation parent: after-creation
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.