Главная / Concurrency / Scoped Values
Concurrency Продвинутый

Scoped Values

Безопасный обмен данными по стеку вызовов без ловушек ThreadLocal.

Сравнение кода
✕ 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);
}
Заметили проблему в этом коде? Сообщите нам.
Почему современный подход лучше
🔒

Неизменяемость

Вызываемые методы могут читать Scoped Value, но не могут его изменить.

🧹

Автоматическая очистка

Нет ручного remove() — значение ограничено блоком.

⚡

Совместимость с виртуальными потоками

Эффективно работает с миллионами виртуальных потоков.

Старый подход
ThreadLocal
Современный подход
ScopedValue
Начиная с JDK
25
Сложность
Продвинутый
Поддержка JDK
Scoped Values
Доступно

Финализировано в JDK 25 LTS (JEP 506, сент. 2025).

Как это работает

ScopedValue предоставляет неизменяемый, наследуемый, ограниченный контекст. В отличие от ThreadLocal, Scoped Values автоматически очищаются, работают с виртуальными потоками и не могут быть изменены вызываемыми методами.

Связанная документация
Scoped Values (JEP 487) ↗ ScopedValue ↗
Доказательство
Посмотреть исходник доказательства ↗
Похожие шаблоны
Concurrency Начинающий

Virtual threads

Java 8
Thread thread = new Thread(() -> {
    System.out.println("hello");
});
thread.start();
thread.join();
Java 21+
Thread.startVirtualThread(() -> {
    IO.println("hello");
}).join();
Наведите, чтобы увидеть современный ➜
JDK 21+ →
Concurrency Продвинутый

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());
}
Наведите, чтобы увидеть современный ➜
JDK 25+ →
Concurrency Продвинутый

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();
}
Наведите, чтобы увидеть современный ➜
JDK 25+ →