Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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

Źródła