Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Java

ThreadLocal — un valore associato a un thread

ThreadLocal memorizza un valore distinto per ogni thread. Scopri l’inizializzazione differita, la lettura, la scrittura e la rimozione, e perché la pulizia è importante per le attività eseguite in un pool di thread.

Versione: Java SE 21; repository runtime, production runtime not attested

Sintassi

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

java.lang.ThreadLocal<T> associa un valore al thread corrente, non a un’attività. Più thread possono usare lo stesso campo ThreadLocal mantenendo valori distinti.

ThreadLocal.withInitial fornisce un inizializzatore. ThreadLocal.get inizializza il valore al primo accesso, a meno che non sia già stato chiamato ThreadLocal.set. Un semplice new ThreadLocal<>() crea un’istanza. La prima chiamata a get() su quell’istanza restituisce null se non è stato impostato alcun valore per il thread corrente. ThreadLocal.set modifica solo il valore del thread corrente.

ThreadLocal.remove elimina l’elemento del thread corrente; il successivo get() lo inizializza di nuovo, a meno che nel frattempo non venga chiamato set(...). set(null) non elimina l’elemento.

In un pool di thread, un valore non rimosso può passare all’attività successiva e trattenere dati inutilmente in memoria. Rimuovi il contesto dell’attività in finally. L’esempio mostra valori indipendenti e la loro reinizializzazione; join() garantisce che l’output finale del thread principale venga dopo quello del thread di lavoro.

Esempi

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();
        }
    }
}

Risultato

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

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti