Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / Java

InheritableThreadLocal — dedovanje vrednosti, lokalnih za nit

InheritableThreadLocal<T> posreduje začetno vrednost iz starševske niti v novo ustvarjeno otroško nit. Do dedovanja pride ob ustvarjanju niti, ne ob klicu start() ali ob oddaji opravila v bazen niti.

Različica: 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 razširja ThreadLocal<T>. Običajni ThreadLocal inicializira svojo vrednost neodvisno za vsako nit; ta podrazred omogoča, da otrok podeduje vrednost starša. get(), set() in remove() delujejo na vrednosti trenutne niti; če vrednost ni nastavljena ali podedovana, je privzeta začetna vrednost null.

Vrednost otroka se določi ob ustvarjanju objekta Thread, ne ob klicu start(). Metodo, ki jo je mogoče prekriti, protected T childValue(T parentValue), izvede starš, preden se otrok zažene. Privzeto vrne prejeti argument: pri objektih to pomeni isto referenco, ne globoke kopije. Poznejši set() v eni niti ne spremeni vezave druge niti, vendar je lahko spremenljiv objekt v skupni rabi in zahteva sinhronizacijo.

V Java SE 21 dedovanje izklopite z inheritInheritableThreadLocals(false) na Thread.Builder; privzeto je vklopljeno. Čas dedovanja prinaša pomembno omejitev: obstoječa delovna nit v bazenu za vsako opravilo ne prejme novega konteksta. Tega mehanizma ne uporabljajte za samodejno posredovanje konteksta zahtevka v bazen. Vrednosti počistite z remove() v bloku finally; s tem odstranite samo vrednost trenutne niti.

Primer uporablja nespremenljive vrednosti String: starš spremeni svojo vrednost po ustvarjanju otroka, vendar pred start(). Otrok še vedno prebere at-creation, njegov lastni set() pa ne nadomesti vrednosti starša. join() zagotovi, da se otrok konča, preden se izpiše vrstica starša.

Primeri

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

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri