Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / Java

util.concurrent.StructuredTaskScope: référence pratique

util.concurrent.StructuredTaskScope: référence pratique: StructuredTaskScope<T> est une API preview de Java 21 qui confine la durée de vie des sous-tâches concurrentes à une portée structurée.

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

Syntaxe

java.util.concurrent.StructuredTaskScope

StructuredTaskScope est une API preview de Java 21 qui confine la durée de vie des sous-tâches concurrentes à une portée structurée.

Utilise try-with-resources : fork des sous-tâches, join comme owner, examine résultats ou échecs puis ferme la portée.

Les preview features doivent être activées ; seul l’owner appelle join et close, et close signale l’absence de join après fork.

shutdown interrompt les sous-tâches inachevées mais exige leur coopération ; ShutdownOnFailure et ShutdownOnSuccess appliquent des courts-circuits différents.

L’exemple exerce l’élément documenté dans un petit programme déterministe et compare exactement la sortie standard.

Exemples

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

Résultat

42

L’exemple exerce l’élément documenté dans un petit programme déterministe et compare exactement la sortie standard.

Sources