CKTIS / Java
ThreadLocal: inicjalizacja, zapis, odczyt i usuwanie
Wspólna instancja `ThreadLocal` przechowuje osobną wartość dla każdego wątku. Usunięcie wartości umożliwia ponowną inicjalizację przy następnym odczycie, ale mechanizm nie kopiuje obiektów.
Wersja: Java SE 21
Składnia
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()W Java SE 21 ta sama instancja java.lang.ThreadLocal<T> może być używana przez wiele wątków. Każdy z nich ma własny wpis dla tej instancji. get(), set(T value) i remove() działają wyłącznie na wpisie bieżącego wątku.
Statyczna metoda ThreadLocal.withInitial(supplier) tworzy instancję bez wywoływania funkcji dostarczającej wartość. Gdy get() nie znajduje wpisu dla bieżącego wątku, wywołuje supplier.get(), zapisuje wynik i go zwraca. set(value) zapisuje lub zastępuje wartość bez wywoływania dostawcy, więc zapis przed pierwszym odczytem pomija inicjalizację. set(null) zapisuje wartość null; wpis nadal istnieje. Przekazanie null zamiast dostawcy do withInitial powoduje NullPointerException.
remove() usuwa wpis, lecz nie inicjalizuje go od razu. Następne get() w tym samym wątku ponownie wywoła dostawcę, chyba że wcześniej nastąpi set(...). W puli wątków kolejna operacja na tym samym wątku może odczytać pozostawioną wartość, a dane mogą być przechowywane dłużej, niż potrzeba. Jeżeli zadanie zarządza własnym wpisem, usuń go w finally na tym samym wątku roboczym.
Rozdzielone są wpisy, a nie obiekty. Jeśli dostawca zwraca obu wątkom ten sam mutowalny obiekt, nadal go współdzielą. ThreadLocal nie wykonuje głębokiej kopii ani nie synchronizuje dostępu do tego obiektu.
Przykłady
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();
}
}
}Wynik
worker first get: default worker after set(null): null worker after remove: default main after join: main-value
Wątek roboczy odczytuje `default`, po `set(null)` odczytuje `null`, a po `remove()` otrzymuje ponownie `default`. `join()` czeka na jego zakończenie, po czym wątek główny wypisuje swoją niezmienioną wartość `main-value`.
Powiązane lekcje
- Java · Lekcja 33 · Zaawansowany · Wersja: 2