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.StructuredTaskScopeStructuredTaskScope é 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.