Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła