CKTIS / Java
ThreadLocal — um valor associado a uma thread
ThreadLocal armazena um valor separado para cada thread. Aprende sobre a inicialização diferida, a leitura, a escrita e a remoção, e por que motivo a limpeza é importante para tarefas executadas num conjunto de threads.
Versão: Java SE 21; repository runtime, production runtime not attested
Sintaxe
ThreadLocal<T> local = ThreadLocal.withInitial(() -> initialValue);
local.set(newValue);
T value = local.get();
local.remove();java.lang.ThreadLocal<T> associa um valor à thread atual, não a uma tarefa. Várias threads podem usar o mesmo campo ThreadLocal e manter valores distintos.
ThreadLocal.withInitial fornece um inicializador. ThreadLocal.get inicializa o valor no primeiro acesso, a menos que ThreadLocal.set tenha sido chamado anteriormente. Um simples new ThreadLocal<>() cria uma instância. A primeira chamada a get() nessa instância devolve null se ainda não tiver sido definido um valor para a thread atual. ThreadLocal.set altera apenas o valor da thread atual.
ThreadLocal.remove elimina a entrada da thread atual; o próximo get() volta a inicializá-la, a menos que set(...) seja chamado entretanto. set(null) não elimina a entrada.
Num conjunto de threads, um valor que não seja removido pode passar para a tarefa seguinte e manter dados na memória sem necessidade. Remove o contexto da tarefa em finally. O exemplo mostra valores independentes e a sua reinicialização; join() garante que a saída final da thread principal surge depois da saída da thread de trabalho.
Exemplos
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
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.