Strona główna / Concurrency / Wartości zasięgowe
Concurrency Zaawansowany

Wartości zasięgowe

Bezpiecznie współdziel dane w stosie wywołań bez pułapek ThreadLocal.

Porównanie kodu
✕ Java 8 
static final ThreadLocal<User> CURRENT =
    new ThreadLocal<>();
void handle(Request req) {
    CURRENT.set(authenticate(req));
    try { process(); }
    finally { CURRENT.remove(); }
}
✓ Java 25 
static final ScopedValue<User> CURRENT =
    ScopedValue.newInstance();
void handle(Request req) {
    ScopedValue.where(CURRENT,
        authenticate(req)
    ).run(this::process);
}
Widzisz problem z tym kodem? Daj nam znać.
Dlaczego nowoczesne podejście wygrywa
🔒

Niemutowalny

Wywołani mogą odczytywać, ale nigdy nie modyfikować wartości zasięgowej.

🧹

Automatyczne sprzątanie

Bez ręcznego remove() — wartość jest zasięgiem ograniczona do bloku.

⚡

Bezpieczny dla wątków wirtualnych

Działa efektywnie z milionami wątków wirtualnych.

Stare podejście
ThreadLocal
Nowoczesne podejście
ScopedValue
Od JDK
25
Poziom trudności
Zaawansowany
Wsparcie JDK
Wartości zasięgowe
Dostępne

Sfinalizowane w JDK 25 LTS (JEP 506, wrzesień 2025)

Jak to działa

ScopedValue zapewnia niemutowalny, dziedziczony, ograniczony zasięgiem kontekst. W przeciwieństwie do ThreadLocal, wartości zasięgowe są automatycznie czyszczone, działają z wątkami wirtualnymi i nie mogą być mutowane przez wywoływanych.

Powiązana dokumentacja
Scoped Values (JEP 487) ↗ ScopedValue ↗
Dowód
Zobacz źródło dowodu ↗
Powiązane wzorce
Concurrency Początkujący

Virtual threads

Java 8
Thread thread = new Thread(() -> {
    System.out.println("hello");
});
thread.start();
thread.join();
Java 21+
Thread.startVirtualThread(() -> {
    IO.println("hello");
}).join();
Najedź, aby zobaczyć nową wersję ➜
JDK 21+ →
Concurrency Zaawansowany

Structured concurrency

Java 8
ExecutorService exec =
    Executors.newFixedThreadPool(2);
Future<User> u = exec.submit(this::fetchUser);
Future<Order> o = exec.submit(this::fetchOrder);
try {
    return combine(u.get(), o.get());
} finally { exec.shutdown(); }
Java 25 (Preview)
try (var scope = new StructuredTaskScope
        .ShutdownOnFailure()) {
    var u = scope.fork(this::fetchUser);
    var o = scope.fork(this::fetchOrder);
    scope.join().throwIfFailed();
    return combine(u.get(), o.get());
}
Najedź, aby zobaczyć nową wersję ➜
JDK 25+ →
Concurrency Zaawansowany

Stable values

Java 8
private volatile Logger logger;
Logger getLogger() {
    if (logger == null) {
        synchronized (this) {
            if (logger == null)
                logger = createLogger();
        }
    }
    return logger;
}
Java 25 (Preview)
private final StableValue<Logger> logger =
    StableValue.of(this::createLogger);

Logger getLogger() {
    return logger.get();
}
Najedź, aby zobaczyć nową wersję ➜
JDK 25+ →