База знанияИзпитен център
BGБългарски
Избери език13

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

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници