Java Academy · 강의

StructuredTaskScope

하위 작업을 포크하고 조인합니다

StructuredTaskScope은(는) CoddyKit의 무료 Java Academy 강의입니다. 이것은 4개 중 2번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 Java Academy 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. Java Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

StructuredTaskScope 알아보기

StructuredTaskScope는 구조적 동시성의 핵심 API입니다. scope를 열고, 하위 작업을 fork하고, 작업이 끝날 때까지 join한 다음 결과를 읽습니다.

프리뷰 기능이므로 --enable-preview를 사용하여 컴파일하고 실행해야 합니다.

기본 수명 주기

모든 사용 방식은 다음 네 단계의 동일한 흐름을 따릅니다.

리소스 자동 관리 블록 안에서 scope를 엽니다
하나 이상의 하위 작업을 fork하며, 각 작업은 Subtask 핸들을 반환합니다
완료될 때까지 기다리도록 join합니다
get()을 통해 각 하위 작업의 결과를 읽습니다

fork는 핸들을 반환함

fork(Callable)는 가상 스레드에서 하위 작업을 즉시 시작하고 Subtask를 반환합니다. join()이 반환되기 전에는 해당 하위 작업의 get()을 호출해서는 안 됩니다.

완전한 예제

여기서는 두 하위 작업이 동시에 실행됩니다. 결과를 읽기 전에 두 작업이 모두 끝나야 합니다. 이 예제에서는 기본 제공 정책인 ShutdownOnFailure를 사용합니다.

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 후 get 읽기

호출 순서는 엄격합니다. fork한 다음 join하고, 그다음 get합니다. join()이 완료되기 전에 하위 작업에서 get()을 호출하면 IllegalStateException이 발생합니다.

이 규칙 덕분에 수명이 구조화된 상태로 유지됩니다.

하위 작업 상태

join() 후에는 각 Subtask가 state()를 보고합니다.

SUCCESS: get()으로 결과를 얻을 수 있습니다
FAILED: exception()으로 예외를 얻을 수 있습니다
UNAVAILABLE: 아직 완료되지 않았습니다

많은 하위 작업

원하는 만큼 하위 작업을 fork할 수 있으며, 각 작업은 자체 가상 스레드를 얻습니다. 이렇게 하면 서로 독립적인 호출을 일괄적으로 여러 작업으로 확장할 수 있습니다.

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

scope가 스레드를 소유함

scope는 AutoCloseable입니다. try 블록이 끝나면 close()가 모든 하위 작업 스레드가 종료되었는지 확인합니다. 누수가 발생할 수 없습니다.

따라서 항상 리소스 자동 관리 방식 안에서 사용해야 합니다.

기본 제공 정책

JDK는 바로 사용할 수 있는 두 가지 종료 정책을 제공합니다.

ShutdownOnFailure: 하위 작업 하나라도 실패하면 나머지를 취소합니다
ShutdownOnSuccess: 하나가 성공하면 나머지를 취소합니다

또한 StructuredTaskScope를 상속하여 사용자 지정 로직을 구현할 수도 있습니다.

같은 스레드에서 join

scope를 연 스레드만 해당 scope로 fork하고 join을 호출할 수 있습니다. 하위 작업은 자신을 소유한 scope에 한정되므로 트리 구조가 올바르게 유지됩니다.

컴파일 및 실행 플래그

이 API는 프리뷰 기능이므로 다음과 같이 빌드해야 합니다.

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

플래그가 없으면 컴파일 오류나 실행 오류가 발생합니다.

빠른 확인

필수 호출 순서를 떠올려 보십시오.

복습

StructuredTaskScope API를 배웠습니다.

리소스 자동 관리 방식에서 열고, fork하고, join한 다음 get합니다
각 하위 작업은 자체 가상 스레드에서 실행됩니다
scope는 닫히기 전에 모든 하위 작업이 종료되도록 보장합니다
--enable-preview가 필요합니다

다음: 실패 시 종료 및 성공 시 종료 정책을 자세히 살펴봅니다.

자주 묻는 질문

“StructuredTaskScope” 강의는 무료인가요?

네 — “StructuredTaskScope” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 Java Academy 강의 전체를 잠금 해제할 수 있습니다. Java Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

“StructuredTaskScope”에서 뭘 배우나요?

하위 작업을 포크하고 조인합니다 브라우저에서 직접 실행하는 실습 코드로 Java Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.

Java Academy을(를) 시작하는 데 경험이 필요한가요?

사전 경험은 필요하지 않습니다. CoddyKit의 Java Academy은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 2번째 강의입니다.

“StructuredTaskScope” 강의는 얼마나 걸리나요?

대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.

이 Java Academy 강의에서 코드를 작성하고 실행할 수 있나요?

네. 모든 Java Academy 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.

이 강의의 모든 강의

← Java Academy(으)로 돌아가기