CKTIS / Java
InheritableThreadLocal — overerving van thread-lokale waarden
InheritableThreadLocal<T> geeft een beginwaarde door van een ouderthread aan een nieuw aangemaakte kindthread. Overerving vindt plaats wanneer de thread wordt aangemaakt, niet bij start() of wanneer een taak aan een threadpool wordt aangeboden.
Versie: 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> uit java.lang breidt ThreadLocal<T> uit. Een gewone ThreadLocal initialiseert de waarde onafhankelijk voor elke thread; met deze subklasse kan een kind de waarde van de ouder erven. get(), set() en remove() werken op de waarde van de huidige thread; zonder ingestelde of geërfde waarde is de standaard beginwaarde null.
De waarde van het kind wordt bepaald wanneer het Thread-object wordt aangemaakt, niet bij start(). De overschrijfbare methode protected T childValue(T parentValue) wordt in de ouder uitgevoerd voordat het kind start. Standaard geeft deze methode het argument terug: bij objecten betekent dit dezelfde verwijzing, geen diepe kopie. Een latere set() in één thread verandert de binding van de andere thread niet, maar een muteerbaar object kan gedeeld zijn en synchronisatie vereisen.
In Java SE 21 schakelt inheritInheritableThreadLocals(false) op Thread.Builder overerving uit; standaard is deze ingeschakeld. Het tijdstip van overerving brengt een belangrijke beperking met zich mee: een bestaande workerthread in een pool krijgt niet voor elke taak een nieuwe context. Gebruik dit mechanisme niet voor automatische doorgifte van requestcontext naar een pool. Ruim waarden op met remove() in finally; daarmee wordt alleen de waarde van de huidige thread verwijderd.
Het voorbeeld gebruikt onveranderlijke String-waarden: de ouder verandert de waarde nadat het kind is aangemaakt, maar vóór start(). Het kind leest nog steeds at-creation, en de eigen set() vervangt de waarde van de ouder niet. join() zorgt ervoor dat het kind klaar is voordat de regel van de ouder wordt afgedrukt.
Voorbeelden
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();
}
}
}Resultaat
child: at-creation parent: after-creation
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.