Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / Java

InheritableThreadLocal — dědění hodnot lokálních pro vlákno

InheritableThreadLocal<T> předává počáteční hodnotu z rodičovského vlákna nově vytvořenému potomkovi. K dědění dochází při vytvoření vlákna, nikoli při volání start() ani při předání úlohy do fondu vláken.

Verze: Java SE 21; repository runtime, production runtime not attested

Syntaxe

InheritableThreadLocal<T> context = new InheritableThreadLocal<>();
context.set(value);
T current = context.get();
context.remove();
// Optional override: protected T childValue(T parentValue)

InheritableThreadLocal<T> z balíčku java.lang rozšiřuje ThreadLocal<T>. Běžný ThreadLocal inicializuje svou hodnotu nezávisle pro každé vlákno; tato podtřída umožňuje potomkovi zdědit hodnotu rodiče. get(), set() a remove() pracují s hodnotou aktuálního vlákna; pokud žádná hodnota není nastavena ani zděděna, výchozí počáteční hodnota je null.

Hodnota potomka se určí při vytvoření objektu Thread, nikoli při volání start(). Přepsatelná metoda protected T childValue(T parentValue) se spustí v rodiči před spuštěním potomka. Ve výchozím nastavení vrací předaný argument: u objektů to znamená stejnou referenci, nikoli hlubokou kopii. Pozdější set() v jednom vlákně nezmění vazbu druhého vlákna, ale proměnlivý objekt může být sdílený a vyžadovat synchronizaci.

V Java SE 21 lze dědění vypnout pomocí inheritInheritableThreadLocals(false) na Thread.Builder; ve výchozím nastavení je zapnuté. Načasování dědění přináší důležité omezení: již existující pracovní vlákno ve fondu nedostává pro každou úlohu nový kontext. Nepoužívejte tento mechanismus k automatickému předávání kontextu požadavku do fondu. Hodnoty uklízejte pomocí remove() v bloku finally; odstraní se tím pouze hodnota aktuálního vlákna.

Příklad používá neměnné hodnoty String: rodič změní svou hodnotu po vytvoření potomka, ale před start(). Potomek stále čte at-creation a jeho vlastní set() nenahradí hodnotu rodiče. join() zajistí, že potomek skončí před vypsáním řádku rodiče.

Příklady

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();
        }
    }
}

Výsledek

child: at-creation
parent: after-creation

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje