Java Academy · Lección

StructuredTaskScope

Lance y una subtareas

StructuredTaskScope es una lección gratuita de Java Academy en CoddyKit. Esta es la lección 2 de 4. Puedes leer la lección completa abajo gratuitamente — luego la practicas en el navegador con un editor de código integrado y un tutor de IA 24/7. Forma parte de la ruta de aprendizaje de Java Academy, y tu progreso se sincroniza en la web y la app de CoddyKit. El curso de Java Academy incluye 4 lecciones en total.

Conozca StructuredTaskScope

StructuredTaskScope es la API principal de la concurrencia estructurada. Abra un ámbito, haga fork de las subtareas, use join para esperarlas y, después, lea sus resultados.

Es una funcionalidad en vista previa, por lo que debe compilar y ejecutar con --enable-preview.

El ciclo de vida básico

Cada uso sigue el mismo ritmo de cuatro pasos:

Abra el ámbito en un bloque try-with-resources
Llame a fork para una o más subtareas; cada llamada devuelve una referencia Subtask
Llame a join para esperar a que finalicen
Lea el resultado de cada subtarea mediante get()

Fork devuelve una referencia

fork(Callable) inicia inmediatamente la subtarea en un hilo virtual y devuelve un Subtask. No debe llamar a su get() hasta que join() finalice.

Un ejemplo completo

Aquí se ejecutan dos subtareas de forma concurrente. Ambas deben finalizar antes de que leamos los resultados. Se utiliza ShutdownOnFailure, una política integrada.

import java.util.concurrent.StructuredTaskScope;

public class Main {
    public static void main(String[] args) throws Exception {
        try (var scope = new StructuredTaskScope.ShutdownOnFailure()) {
            var name = scope.fork(() -> "Grace");
            var count = scope.fork(() -> 3);
            scope.join();
            scope.throwIfFailed();
            System.out.println(name.get() + " placed " + count.get() + " orders");
        }
    }
}

join y después get

La regla de orden es estricta: fork, luego join y después get. Llamar a get() en una subtarea antes de que finalice join() provoca una IllegalStateException.

Esta regla es la que mantiene estructurado el ciclo de vida.

Estados de las subtareas

Después de join(), cada Subtask informa de un state():

SUCCESS, con un resultado obtenido mediante get()
FAILED, con la excepción obtenida mediante exception()
UNAVAILABLE, si nunca se completó

Muchas subtareas

Puede hacer fork de tantas subtareas como quiera; cada una obtiene su propio hilo virtual. Así puede distribuir un lote de llamadas independientes.

import java.util.*;
import java.util.concurrent.StructuredTaskScope;

public class Main {
    public static void main(String[] args) throws Exception {
        try (var scope = new StructuredTaskScope.ShutdownOnFailure()) {
            List<StructuredTaskScope.Subtask<Integer>> tasks = new ArrayList<>();
            for (int i = 1; i <= 5; i++) {
                final int n = i;
                tasks.add(scope.fork(() -> n * n));
            }
            scope.join();
            scope.throwIfFailed();
            int total = tasks.stream().mapToInt(StructuredTaskScope.Subtask::get).sum();
            System.out.println("Sum of squares 1..5 = " + total);
        }
    }
}

El ámbito es propietario de los hilos

El ámbito es un AutoCloseable. Cuando finaliza el bloque try, close() garantiza que todos los hilos de las subtareas hayan terminado. No puede haber fugas.

Por eso siempre debe utilizarlo dentro de try-with-resources.

Políticas integradas

El JDK incluye dos políticas de cierre listas para usar:

ShutdownOnFailure: cancela las demás si falla alguna subtarea
ShutdownOnSuccess: cancela las demás cuando una tiene éxito

También puede crear una subclase de StructuredTaskScope para implementar una lógica personalizada.

Uniones desde el mismo hilo

Solo el hilo que abrió el ámbito puede hacer fork en él y llamar a join. Las subtareas están confinadas a su ámbito propietario, lo que mantiene el árbol bien formado.

Opciones para compilar y ejecutar

Como la API está en vista previa, compile con:

javac --release 21 --enable-preview Main.java
java --enable-preview Main

Sin la opción, se produce un error de compilación o de ejecución.

Comprobación rápida

Recuerde el orden obligatorio de las llamadas.

Resumen

Ha aprendido a utilizar la API StructuredTaskScope:

Ábrala en try-with-resources, use fork, después join y, por último, get
Cada subtarea se ejecuta en su propio hilo virtual
El ámbito garantiza que todas las subtareas terminen antes de cerrarse
Requiere --enable-preview

A continuación: las políticas shutdown-on-failure y shutdown-on-success en profundidad.

Preguntas frecuentes

¿La lección «StructuredTaskScope» es gratis?

Sí — el texto completo de «StructuredTaskScope» es gratis para leer aquí en la web. Para practicarla de forma interactiva (editor de código integrado y tutor de IA 24/7) y desbloquear el resto del curso de Java Academy, actualiza a CoddyKit PRO. El curso de Java Academy incluye 4 lecciones en total.

¿Qué aprenderé en «StructuredTaskScope»?

Lance y una subtareas Practicas Java Academy con código real que ejecutas directamente en el navegador, y un tutor de IA 24/7 responde tus preguntas mientras trabajas en la lección.

¿Necesito experiencia previa para empezar Java Academy?

No se requiere experiencia previa. Java Academy en CoddyKit está estructurado para principiantes hasta estudiantes avanzados, así que puedes empezar aquí o desde el inicio y avanzar a tu ritmo. Esta es la lección 2 de 4.

¿Cuánto tiempo toma la lección «StructuredTaskScope»?

La mayoría de las lecciones de CoddyKit toman alrededor de 5–10 minutos. Cada una es compacta e interactiva, así que avanzas constantemente y retomas exactamente por donde dejaste en la web y la app.

¿Puedo escribir y ejecutar código en esta lección de Java Academy?

Sí. Cada lección de Java Academy incluye un editor de código integrado, así que escribes y ejecutas código real directamente en tu navegador y obtienes retroalimentación instantánea de IA — sin configuración local necesaria.

Todas las lecciones de este curso

← Volver a Java Academy