ホーム / Concurrency / スコープ付き値
Concurrency 上級

スコープ付き値

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);
}
このコードに問題がありますか？ お知らせください。
モダンな方法が優れている理由
🔒

イミュータブル

呼び出し先はスコープ付き値を読み取ることはできますが、変更はできません。

🧹

自動クリーンアップ

手動のremove()不要 — 値はブロックにスコープされます。

⚡

バーチャルスレッド対応

何百万ものバーチャルスレッドで効率的に動作します。

旧来のアプローチ
ThreadLocal
モダンなアプローチ
ScopedValue
JDKバージョン
25
難易度
上級
JDKサポート
スコープ付き値
利用可能

JDK 25 LTSで正式リリース（JEP 506、2025年9月）。

仕組み

ScopedValueはイミュータブルで継承可能なスコープ限定のコンテキストを提供します。ThreadLocalとは異なり、スコープ付き値は自動的にクリーンアップされ、バーチャルスレッドで動作し、呼び出し先から変更できません。

関連ドキュメント
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+ →
共有 𝕏 🦋 in ⬡