CKTIS / Java
InheritableThreadLocal — herencia de valores locales al hilo
InheritableThreadLocal<T> transmite un valor inicial desde un hilo padre a un hilo hijo recién creado. La herencia se produce al crear el hilo, no al llamar a start() ni al enviar una tarea a un grupo de hilos.
Versión: Java SE 21; repository runtime, production runtime not attested
Sintaxis
InheritableThreadLocal<T> context = new InheritableThreadLocal<>();
context.set(value);
T current = context.get();
context.remove();
// Optional override: protected T childValue(T parentValue)InheritableThreadLocal<T> del paquete java.lang extiende ThreadLocal<T>. Un ThreadLocal normal inicializa su valor de forma independiente para cada hilo; esta subclase permite que un hijo herede el valor del padre. get(), set() y remove() actúan sobre el valor del hilo actual; si no se establece ni se hereda ningún valor, el valor inicial predeterminado es null.
El valor del hijo se determina al crear el objeto Thread, no al llamar a start(). El método que se puede sobrescribir, protected T childValue(T parentValue), se ejecuta en el padre antes de que se inicie el hijo. De forma predeterminada, devuelve el argumento recibido: para los objetos, esto significa la misma referencia, no una copia profunda. Un set() posterior en un hilo no cambia la asociación del otro, pero un objeto mutable puede compartirse y requerir sincronización.
En Java SE 21, inheritInheritableThreadLocals(false) en Thread.Builder desactiva la herencia; de forma predeterminada está activada. El momento en que se produce la herencia implica una limitación importante: un hilo de trabajo que ya existe en un grupo no recibe un contexto nuevo para cada tarea. No uses este mecanismo para propagar automáticamente el contexto de una solicitud a un grupo. Limpia los valores con remove() en un bloque finally; esto elimina únicamente el valor del hilo actual.
El ejemplo usa valores String inmutables: el padre cambia su valor después de crear el hijo, pero antes de start(). El hijo sigue leyendo at-creation, y su propio set() no sustituye el valor del padre. join() garantiza que el hijo termine antes de que se imprima la línea del padre.
Ejemplos
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();
}
}
}Resultado
child: at-creation parent: after-creation
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.