CKTIS / Java
util.concurrent.StructuredTaskScope: praktische referentie
util.concurrent.StructuredTaskScope: praktische referentie: StructuredTaskScope<T> is een preview-API van Java 21 die de levensduur van gelijktijdige subtaken tot een gestructureerde scope beperkt.
Versie: Java SE 21 (JLS and Java SE API); examples verified on the repository Java runtime
Syntax
java.util.concurrent.StructuredTaskScopeStructuredTaskScope is een preview-API van Java 21 die de levensduur van gelijktijdige subtaken tot een gestructureerde scope beperkt.
Gebruik try-with-resources: fork subtaken, join als owner, controleer resultaten of fouten en sluit de scope.
Preview features moeten aanstaan; alleen de owner mag join en close aanroepen en close meldt misbruik als na fork geen join volgde.
shutdown onderbreekt onvoltooide subtaken maar vereist medewerking; ShutdownOnFailure en ShutdownOnSuccess bieden verschillende kortsluitregels.
Het voorbeeld gebruikt het gedocumenteerde element in een klein deterministisch programma en vergelijkt de exacte standaarduitvoer.
Voorbeelden
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);
}
}
}
Resultaat
42
Het voorbeeld gebruikt het gedocumenteerde element in een klein deterministisch programma en vergelijkt de exacte standaarduitvoer.