CKTIS / Java
util.concurrent.StructuredTaskScope: referencia práctica
util.concurrent.StructuredTaskScope: referencia práctica: StructuredTaskScope<T> es una API preview de Java 21 que limita la vida de subtareas concurrentes a un ámbito estructurado.
Versión: Java SE 21 (JLS and Java SE API); examples verified on the repository Java runtime
Sintaxis
java.util.concurrent.StructuredTaskScopeStructuredTaskScope es una API preview de Java 21 que limita la vida de subtareas concurrentes a un ámbito estructurado.
Úsala con try-with-resources: fork subtareas, join como owner, revisa resultados o fallos y cierra el ámbito.
Requiere preview features; solo el owner puede llamar join y close, y close informa del uso incorrecto si faltó join tras fork.
shutdown interrumpe subtareas inacabadas pero requiere cooperación; ShutdownOnFailure y ShutdownOnSuccess ofrecen políticas de cortocircuito distintas.
El ejemplo ejercita el elemento documentado en un programa pequeño y determinista y compara exactamente la salida estándar.
Ejemplos
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
El ejemplo ejercita el elemento documentado en un programa pequeño y determinista y compara exactamente la salida estándar.