Início / Concurrency / Valores com escopo
Concurrency Avançado

Valores com escopo

Compartilhe dados entre pilhas de chamadas com segurança, sem as armadilhas do ThreadLocal.

Comparação de Código
✕ 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);
}
Viu um problema com este código? Nos avise.
Por que a forma moderna ganha
🔒

Imutável

Os chamados podem ler, mas nunca modificar o valor com escopo.

🧹

Limpeza automática

Sem remove() manual — o valor é limitado ao bloco.

⚡

Seguro para virtual threads

Funciona eficientemente com milhões de virtual threads.

Abordagem Antiga
ThreadLocal
Abordagem Moderna
ScopedValue
Desde o JDK
25
Dificuldade
Avançado
Suporte JDK
Valores com escopo
Disponível

Finalizado no JDK 25 LTS (JEP 506, setembro de 2025).

Como funciona

ScopedValue fornece contexto imutável, herdável e limitado ao escopo. Diferente de ThreadLocal, valores com escopo são automaticamente limpos, funcionam com virtual threads e não podem ser alterados pelos chamados.

Documentação Relacionada
Scoped Values (JEP 487) ↗ ScopedValue ↗
Padrões relacionados
Concurrency Iniciante

Virtual threads

Java 8
Thread thread = new Thread(() -> {
    System.out.println("hello");
});
thread.start();
thread.join();
Java 21+
Thread.startVirtualThread(() -> {
    IO.println("hello");
}).join();
Passe o mouse para ver o moderno ➜
JDK 21+ →
Concurrency Avançado

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());
}
Passe o mouse para ver o moderno ➜
JDK 25+ →
Concurrency Avançado

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();
}
Passe o mouse para ver o moderno ➜
JDK 25+ →
Compartilhar 𝕏 🦋 in ⬡