CKTIS / Java
InheritableThreadLocal — наследяване на стойности, локални за нишката
InheritableThreadLocal<T> предава начална стойност от родителска нишка към новосъздадена дъщерна нишка. Наследяването става при създаването на нишката, а не при извикване на start() или при подаване на задача към пул.
Версия: Java SE 21; repository runtime, production runtime not attested
Синтаксис
InheritableThreadLocal<T> context = new InheritableThreadLocal<>();
context.set(value);
T current = context.get();
context.remove();
// Optional override: protected T childValue(T parentValue)InheritableThreadLocal<T> от пакета java.lang разширява ThreadLocal<T>. Обикновеният ThreadLocal инициализира стойността си независимо за всяка нишка; този подклас позволява на дъщерната нишка да наследи стойността на родителската. get(), set() и remove() действат върху стойността на текущата нишка; ако няма зададена или наследена стойност, началната стойност по подразбиране е null.
Стойността на дъщерната нишка се определя при създаването на обекта Thread, а не при извикване на start(). Методът, който може да бъде предефиниран, protected T childValue(T parentValue), се изпълнява в родителската нишка преди стартирането на дъщерната. По подразбиране връща подадения аргумент: при обектите това означава същата референция, а не дълбоко копие. По-късно извикване на set() в едната нишка не променя обвързването в другата, но изменяем обект може да е споделен и да изисква синхронизация.
В Java SE 21 наследяването може да се изключи чрез inheritInheritableThreadLocals(false) върху Thread.Builder; по подразбиране е включено. Моментът на наследяване води до важно ограничение: вече съществуваща работна нишка в пул не получава нов контекст за всяка задача. Не използвайте този механизъм за автоматично предаване на контекста на заявка към пул. Почиствайте стойностите с remove() в блок finally; така се премахва само стойността на текущата нишка.
Примерът използва неизменяеми стойности String: родителската нишка променя стойността си след създаването на дъщерната, но преди start(). Дъщерната нишка все пак прочита at-creation, а нейното собствено set() не заменя стойността на родителската. join() гарантира, че дъщерната нишка приключва, преди да бъде отпечатан редът на родителската.
Примери
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();
}
}
}Резултат
child: at-creation parent: after-creation
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.