Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / Java

InheritableThreadLocal — nasljeđivanje vrijednosti lokalnih za dretvu

InheritableThreadLocal<T> prenosi početnu vrijednost iz roditeljske dretve u novostvorenu dijete-dretvu. Nasljeđivanje se događa pri stvaranju dretve, a ne pri pozivu start() ili predaji zadatka skupu dretvi.

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

Sintaksa

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

InheritableThreadLocal<T> iz paketa java.lang proširuje ThreadLocal<T>. Obični ThreadLocal neovisno inicijalizira svoju vrijednost za svaku dretvu; ova podklasa omogućuje djetetu da naslijedi vrijednost roditelja. get(), set() i remove() djeluju na vrijednost trenutačne dretve; ako vrijednost nije postavljena ni naslijeđena, zadana početna vrijednost je null.

Vrijednost djeteta određuje se pri stvaranju objekta Thread, a ne pri pozivu start(). Metoda koju je moguće nadjačati, protected T childValue(T parentValue), izvršava se u roditelju prije pokretanja djeteta. Prema zadanim postavkama vraća primljeni argument: za objekte to znači istu referencu, a ne duboku kopiju. Kasniji set() u jednoj dretvi ne mijenja vezu druge dretve, ali promjenjiv objekt može se dijeliti i zahtijevati sinkronizaciju.

U Java SE 21 nasljeđivanje se može isključiti pomoću inheritInheritableThreadLocals(false) na Thread.Builder; zadano je uključeno. Vrijeme nasljeđivanja donosi važno ograničenje: postojeća radna dretva u skupu ne dobiva novi kontekst za svaki zadatak. Nemojte koristiti ovaj mehanizam za automatsko prenošenje konteksta zahtjeva u skup. Uklanjajte vrijednosti pomoću remove() u bloku finally; time se uklanja samo vrijednost trenutačne dretve.

Primjer koristi nepromjenjive vrijednosti String: roditelj mijenja svoju vrijednost nakon stvaranja djeteta, ali prije start(). Dijete i dalje čita at-creation, a njegov vlastiti set() ne zamjenjuje vrijednost roditelja. join() osigurava da dijete završi prije ispisa retka roditelja.

Primjeri

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

Rezultat

child: at-creation
parent: after-creation

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori