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

CKTIS / Java

ThreadLocal: inicializar, asignar, leer y eliminar valores por hilo

Una instancia compartida de `ThreadLocal` mantiene un valor separado para cada hilo. Eliminarlo permite que la siguiente lectura vuelva a inicializarlo, pero no se copian los objetos.

Versión: Java SE 21

Sintaxis

java.lang.ThreadLocal<T> (Java SE 21)

import java.util.function.Supplier;

// Method signatures:
public static <S> ThreadLocal<S> withInitial(Supplier<? extends S> supplier)
public void set(T value)
public T get()
public void remove()

En Java SE 21, varios hilos pueden usar la misma instancia de java.lang.ThreadLocal<T>, pero cada uno tiene su propia entrada para esa instancia. get(), set(T value) y remove() solo actúan sobre la entrada del hilo que llama al método.

El método estático ThreadLocal.withInitial(supplier) crea la instancia sin llamar al proveedor. Cuando get() no encuentra una entrada para el hilo actual, llama a supplier.get(), guarda el resultado y lo devuelve. set(value) guarda o sustituye el valor sin llamar al proveedor, de modo que una asignación previa a la primera lectura evita la inicialización. set(null) guarda null; la entrada sigue existiendo. Pasar null como proveedor a withInitial lanza NullPointerException.

remove() elimina la entrada sin inicializarla de inmediato. El siguiente get() en el mismo hilo vuelve a llamar al proveedor, salvo que se ejecute antes set(...). En un grupo de hilos, otra tarea que se ejecute después en el mismo hilo puede leer un valor residual, y los datos pueden mantenerse más tiempo del necesario. Si la tarea es responsable de la entrada, elimínala con remove() dentro de finally en ese mismo hilo.

Lo que se separa son las entradas, no necesariamente los objetos. Si el proveedor devuelve a ambos hilos el mismo objeto mutable, estos siguen compartiéndolo. ThreadLocal no realiza una copia profunda ni sincroniza el acceso al objeto.

Ejemplos

public class Main {
    private static final ThreadLocal<String> LOCAL =
            ThreadLocal.withInitial(() -> "default");

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

Resultado

worker first get: default
worker after set(null): null
worker after remove: default
main after join: main-value

El hilo de trabajo lee `default`, luego `null` tras `set(null)` y de nuevo `default` tras `remove()`. `join()` espera a que termine antes de que el hilo principal imprima su valor intacto, `main-value`.

Lecciones relacionadas

  • Java · Lección 33 · Avanzado · Versión: 2

Fuentes