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

CKTIS / Java

ThreadLocal: un valor asociado a un hilo

ThreadLocal almacena un valor independiente para cada hilo. Aprende sobre la inicialización diferida, la lectura, la escritura y la eliminación, y por qué es importante limpiar los datos de las tareas ejecutadas en un grupo de hilos.

Versión: Java SE 21; repository runtime, production runtime not attested

Sintaxis

ThreadLocal<T> local = ThreadLocal.withInitial(() -> initialValue);
local.set(newValue);
T value = local.get();
local.remove();

java.lang.ThreadLocal<T> asocia un valor al hilo actual, no a una tarea. Varios hilos pueden usar un mismo campo ThreadLocal y conservar valores distintos.

ThreadLocal.withInitial proporciona un inicializador. ThreadLocal.get inicializa el valor en el primer acceso, salvo que antes se haya llamado a ThreadLocal.set. La expresión new ThreadLocal<>() crea una instancia. La primera llamada a get() sobre esa instancia devuelve null si aún no se ha establecido ningún valor para el hilo actual. ThreadLocal.set cambia únicamente el valor del hilo actual.

ThreadLocal.remove elimina la entrada del hilo actual; el siguiente get() vuelve a inicializarla, salvo que antes se llame a set(...). set(null) no elimina la entrada.

En un grupo de hilos, un valor que quede sin limpiar puede llegar a la siguiente tarea y mantener datos en memoria innecesariamente. Elimina el contexto de la tarea en finally. El ejemplo muestra valores independientes y su reinicialización; join() garantiza que la salida final del hilo principal aparezca después de la del hilo de trabajo.

Ejemplos

public class ThreadLocalDemo {
    private static final ThreadLocal<String> CONTEXT =
            ThreadLocal.withInitial(() -> "unset");

    public static void main(String[] args) throws InterruptedException {
        try {
            CONTEXT.set("main");
            Thread worker = new Thread(() -> {
                try {
                    System.out.println("worker initial: " + CONTEXT.get());
                    CONTEXT.set("worker");
                    System.out.println("worker set: " + CONTEXT.get());
                } finally {
                    CONTEXT.remove();
                }
                try {
                    System.out.println("worker reset: " + CONTEXT.get());
                } finally {
                    CONTEXT.remove();
                }
            });
            worker.start();
            worker.join();
            System.out.println("main: " + CONTEXT.get());
        } finally {
            CONTEXT.remove();
        }
    }
}

Resultado

worker initial: unset
worker set: worker
worker reset: unset
main: main

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