CKTIS / Java
util.concurrent.StructuredTaskScope: praktická reference
util.concurrent.StructuredTaskScope: praktická reference: StructuredTaskScope<T> je preview API v Java 21, které omezuje životnost souběžných podúloh na strukturovaný rozsah.
Verze: Java SE 21 (JLS and Java SE API); examples verified on the repository Java runtime
Syntaxe
java.util.concurrent.StructuredTaskScopeStructuredTaskScope je preview API v Java 21, které omezuje životnost souběžných podúloh na strukturovaný rozsah.
Použij try-with-resources: spusť podúlohy přes fork, jako owner zavolej join, zkontroluj výsledky či chyby a rozsah zavři.
Vyžaduje zapnuté preview features; join a close smí volat jen owner a close ohlásí chybu, pokud po fork nenásledoval join.
shutdown přeruší nedokončené podúlohy, ale vyžaduje spolupráci; ShutdownOnFailure a ShutdownOnSuccess mají odlišná pravidla zkrácení.
Příklad používá dokumentovaný prvek v malém deterministickém programu a porovnává přesný standardní výstup.
Příklady
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);
}
}
}
Výsledek
42
Příklad používá dokumentovaný prvek v malém deterministickém programu a porovnává přesný standardní výstup.