Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / Java

util.concurrent.StructuredTaskScope: referência prática

util.concurrent.StructuredTaskScope: referência prática: StructuredTaskScope<T> é uma API preview do Java 21 que confina a vida de subtarefas concorrentes a um âmbito estruturado.

Versão: Java SE 21 (JLS and Java SE API); examples verified on the repository Java runtime

Sintaxe

java.util.concurrent.StructuredTaskScope

StructuredTaskScope é uma API preview do Java 21 que confina a vida de subtarefas concorrentes a um âmbito estruturado.

Usa-a com try-with-resources: faz fork das subtarefas, join como owner, verifica resultados ou falhas e fecha o âmbito.

Exige preview features; só o owner pode chamar join e close, e close assinala uso incorreto se faltou join após fork.

shutdown interrompe subtarefas inacabadas mas exige cooperação; ShutdownOnFailure e ShutdownOnSuccess oferecem políticas de curto-circuito diferentes.

O exemplo exercita o elemento documentado num programa pequeno e determinístico e compara exatamente a saída padrão.

Exemplos

import java.lang.reflect.Method;
import java.util.concurrent.Callable;

public class Main {
    public static void main(String[] args) throws Exception {
        Class<?> scopeType = Class.forName("java.util.concurrent.StructuredTaskScope$ShutdownOnFailure");
        Object scope = scopeType.getConstructor().newInstance();
        try {
            Object subtask = scopeType.getMethod("fork", Callable.class)
                .invoke(scope, (Callable<Integer>) () -> 42);
            scopeType.getMethod("join").invoke(scope);
            scopeType.getMethod("throwIfFailed").invoke(scope);
            Method get = Class.forName("java.util.concurrent.StructuredTaskScope$Subtask").getMethod("get");
            System.out.println(get.invoke(subtask));
        } finally {
            scopeType.getMethod("close").invoke(scope);
        }
    }
}

Resultado

42

O exemplo exercita o elemento documentado num programa pequeno e determinístico e compara exatamente a saída padrão.

Fontes