Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes