WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Java

util.concurrent.StructuredTaskScope: praktische Referenz

util.concurrent.StructuredTaskScope: praktische Referenz: StructuredTaskScope<T> ist eine Preview-API in Java 21, die Lebenszeiten paralleler Unteraufgaben auf einen strukturierten Bereich begrenzt.

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

Syntax

java.util.concurrent.StructuredTaskScope

StructuredTaskScope ist eine Preview-API in Java 21, die Lebenszeiten paralleler Unteraufgaben auf einen strukturierten Bereich begrenzt.

Nutze try-with-resources: Unteraufgaben mit fork starten, als Owner join aufrufen, Ergebnisse oder Fehler prüfen und den Bereich schließen.

Preview Features müssen aktiv sein; nur der Owner darf join und close aufrufen, und close meldet Missbrauch, wenn nach fork kein join erfolgte.

shutdown unterbricht unfertige Unteraufgaben, braucht aber Kooperation; ShutdownOnFailure und ShutdownOnSuccess bieten verschiedene Kurzschlussregeln.

Das Beispiel prüft das dokumentierte Element in einem kleinen deterministischen Programm und vergleicht die exakte Standardausgabe.

Beispiele

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);
        }
    }
}

Ergebnis

42

Das Beispiel prüft das dokumentierte Element in einem kleinen deterministischen Programm und vergleicht die exakte Standardausgabe.

Quellen