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