Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

ThreadLocal — wartość przypisana do wątku

ThreadLocal przechowuje osobną wartość dla każdego wątku. Poznaj leniwą inicjalizację, odczyt, zapis i usuwanie wartości oraz znaczenie sprzątania po zadaniach wykonywanych w puli wątków.

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

Składnia

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

java.lang.ThreadLocal<T> wiąże wartość z bieżącym wątkiem, a nie z zadaniem. Wiele wątków może korzystać z jednego pola ThreadLocal, zachowując osobne wartości.

ThreadLocal.withInitial ustala dostawcę wartości początkowej. ThreadLocal.get inicjalizuje wartość przy pierwszym odczycie, chyba że wcześniej wykonano ThreadLocal.set. Wyrażenie new ThreadLocal<>() tworzy instancję. Pierwsze wywołanie get() na tej instancji zwraca null, jeśli wcześniej nie ustawiono wartości dla bieżącego wątku. ThreadLocal.set zmienia wyłącznie wartość bieżącego wątku.

ThreadLocal.remove usuwa wpis bieżącego wątku; kolejny get() ponownie inicjalizuje wartość, o ile wcześniej nie wykonano set(...). set(null) nie jest usunięciem wpisu.

W puli wątków pozostawiona wartość może trafić do kolejnego zadania i niepotrzebnie utrzymywać dane w pamięci. Usuwaj kontekst zadania w finally. Przykład pokazuje niezależne wartości i ponowną inicjalizację; join() zapewnia końcowy wydruk wątku głównego po wydrukach wątku roboczego.

Przykłady

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

Wynik

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

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła