Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Java

ThreadLocal: inizializzare, impostare, leggere e rimuovere valori per thread

Un'istanza condivisa di `ThreadLocal` conserva un valore distinto per ogni thread. Dopo la rimozione, la lettura successiva può inizializzarlo di nuovo, senza copiare gli oggetti.

Versione: Java SE 21

Sintassi

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

In Java SE 21 più thread possono usare la stessa istanza di java.lang.ThreadLocal<T>, ma ognuno ha una propria voce per quell'istanza. get(), set(T value) e remove() agiscono solo sulla voce del thread chiamante.

Il metodo statico ThreadLocal.withInitial(supplier) crea l'istanza senza invocare il fornitore. Se get() non trova una voce per il thread corrente, chiama supplier.get(), memorizza il risultato e lo restituisce. set(value) memorizza o sostituisce il valore senza chiamare il fornitore: un'assegnazione prima della prima lettura evita quindi l'inizializzazione. set(null) memorizza null senza eliminare la voce. Passare null come fornitore a withInitial causa una NullPointerException.

remove() elimina la voce senza reinizializzarla subito. Il successivo get() nello stesso thread richiama il fornitore, a meno che nel frattempo non venga eseguito set(...). In un pool di thread, un'attività successiva sullo stesso thread può leggere un valore rimasto da un'attività precedente, e i dati possono essere trattenuti più del necessario. Se la voce appartiene all'attività, eliminala con remove() in finally sullo stesso thread.

Le voci sono distinte, ma gli oggetti non lo sono necessariamente. Se il fornitore restituisce a entrambi i thread lo stesso oggetto mutabile, l'oggetto rimane condiviso. ThreadLocal non ne fa una copia profonda e non ne sincronizza l'accesso.

Esempi

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

Risultato

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

Il thread di lavoro legge `default`, poi `null` dopo `set(null)`, poi di nuovo `default` dopo `remove()`. `join()` attende che termini prima che il thread principale stampi il proprio valore invariato, `main-value`.

Lezioni correlate

  • Java · Lezione 33 · Avanzato · Versione: 2

Fonti