Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / Java

ThreadLocal — hodnota přiřazená vláknu

ThreadLocal ukládá pro každé vlákno samostatnou hodnotu. Seznamte se s línou inicializací, čtením, zápisem a odstraněním hodnoty i s tím, proč je úklid důležitý u úloh spouštěných ve fondu vláken.

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

Syntaxe

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

java.lang.ThreadLocal<T> přiřazuje hodnotu aktuálnímu vláknu, nikoli úloze. Více vláken může používat jedno pole ThreadLocal a přitom si uchovávat vlastní hodnoty.

ThreadLocal.withInitial poskytuje inicializační funkci. ThreadLocal.get inicializuje hodnotu při prvním přístupu, pokud dříve nebylo zavoláno ThreadLocal.set. Výraz new ThreadLocal<>() vytvoří instanci. První volání get() na této instanci vrátí null, pokud pro aktuální vlákno dosud nebyla nastavena žádná hodnota. ThreadLocal.set mění pouze hodnotu aktuálního vlákna.

ThreadLocal.remove odstraní záznam aktuálního vlákna; při dalším volání get() se hodnota znovu inicializuje, pokud mezitím nedojde k volání set(...). set(null) záznam neodstraní.

Ve fondu vláken může neodstraněná hodnota přejít na další úlohu a zbytečně držet data v paměti. Kontext úlohy odstraňte v finally. Příklad ukazuje nezávislé hodnoty a opětovnou inicializaci; join() zajistí, že závěrečný výpis hlavního vlákna následuje až po výpisu pracovního vlákna.

Příklady

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

Výsledek

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

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje