Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / Java

InheritableThreadLocal — dedenie hodnôt lokálnych pre vlákno

InheritableThreadLocal<T> odovzdáva počiatočnú hodnotu z rodičovského vlákna novovytvorenému potomkovi. K dedeniu dochádza pri vytvorení vlákna, nie pri volaní start() ani pri odovzdaní úlohy do fondu vlákien.

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

Syntax

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íka java.lang rozširuje ThreadLocal<T>. Bežný ThreadLocal inicializuje svoju hodnotu nezávisle pre každé vlákno; táto podtrieda umožňuje potomkovi zdediť hodnotu rodiča. get(), set() a remove() pracujú s hodnotou aktuálneho vlákna; ak nie je nastavená ani zdedená žiadna hodnota, predvolená počiatočná hodnota je null.

Hodnota potomka sa určí pri vytvorení objektu Thread, nie pri volaní start(). Prepísateľná metóda protected T childValue(T parentValue) sa vykoná v rodičovi pred spustením potomka. Predvolene vráti odovzdaný argument: pri objektoch to znamená tú istú referenciu, nie hlbokú kópiu. Neskoršie set() v jednom vlákne nezmení priradenie druhého vlákna, ale meniteľný objekt môže byť zdieľaný a vyžadovať synchronizáciu.

V Java SE 21 možno dedenie vypnúť pomocou inheritInheritableThreadLocals(false) na Thread.Builder; predvolene je zapnuté. Čas, keď k dedeniu dochádza, prináša dôležité obmedzenie: existujúce pracovné vlákno vo fonde nedostane nový kontext pre každú úlohu. Nepoužívajte tento mechanizmus na automatické odovzdávanie kontextu požiadavky do fondu. Hodnoty čistite pomocou remove() v bloku finally; odstráni sa tým iba hodnota aktuálneho vlákna.

Príklad používa nemenné hodnoty String: rodič zmení svoju hodnotu po vytvorení potomka, ale pred start(). Potomok stále číta at-creation a jeho vlastné set() nenahradí hodnotu rodiča. join() zaistí, že sa potomok skončí pred vypísaním riadka rodiča.

Prí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ýsledok

child: at-creation
parent: after-creation

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje