Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

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.

Fuentes