当前位置:首页 > 文章列表 > 文章 > java教程 > Java StructuredTaskScope.Subtask.state 怎样区分未完成、成功与失败

Java StructuredTaskScope.Subtask.state 怎样区分未完成、成功与失败

来源:17golang原创 2026-11-20 11:34:42 0浏览 收藏

在 Java 结构化并发里,判断子任务“成功还是失败”不能只看 get() 是否抛异常。更稳妥的做法是先调用 Subtask.state():SUCCESS 才读取结果,FAILED 才读取异常,UNAVAILABLE 则表示结果或异常暂时不可用,常见于任务尚未完成或 scope 已取消。

记住一条边界:scope owner 在 join() 之后读取已经成功或失败的子任务;取消后的 UNAVAILABLE 不是业务失败,不能直接当成异常处理。

官方文档:https://docs.oracle.com/en/java/javase/25/docs/api/java.base/java/util/concurrent/StructuredTaskScope.Subtask.html#state()

先把三种状态和可读取内容对齐

state() 返回的是 StructuredTaskScope.Subtask.State。它描述的是子任务当前是否有可供 owner 读取的结果,而不是给业务异常分级。

状态含义后续动作
UNAVAILABLE仍未完成、取消后未产生可用结果,或在取消后创建不要调用 get() 或 exception()
SUCCESS任务正常返回调用 get() 读取结果
FAILED任务以异常或错误结束调用 exception() 读取失败原因
StructuredTaskScope.Subtask.state 三种状态与结果读取关系的静态说明图
图1:Subtask.state() 三种状态与可读取内容的静态说明图,不是截图或运行证据。

在 join 之后读取成功和失败子任务

下面的示例故意安排一个正常返回的任务和一个抛出异常的任务。示例使用 Java 25 的预览版 StructuredTaskScope,编译和运行时要按目标 JDK 开启预览特性。关键点不是把所有调用都包在 try/catch 里,而是先让 scope 完成等待,再按状态选择读取方法。

import java.util.concurrent.StructuredTaskScope;

public class StateDemo {
    public static void main(String[] args) throws Exception {
        // scope 结束时自动关闭,避免遗漏子任务资源回收
        try (var scope = StructuredTaskScope.open()) {
            var success = scope.fork(() -> "ready");
            var failure = scope.fork(() -> {
                // 用异常结束一个子任务,便于观察 FAILED 状态
                throw new IllegalStateException("demo failure");
            });

            // 先等待子任务完成,再由 owner 读取结果或异常
            scope.join();
            printState("success", success);
            printState("failure", failure);
        }
    }

    static void printState(String name, StructuredTaskScope.Subtask task) {
        // state() 决定后续应该调用 get() 还是 exception()
        switch (task.state()) {
            case SUCCESS -> System.out.println(name + ": " + task.get());
            case FAILED -> System.out.println(name + ": " + task.exception());
            case UNAVAILABLE -> System.out.println(name + ": result unavailable");
        }
    }
}

这里的 get() 和 exception() 都只在对应状态分支执行。这样写还有一个好处:失败子任务的异常不会被误当成 scope 自身的异常,后续可以按业务决定记录、降级或终止父任务。

处理取消和读取时机

UNAVAILABLE 是最容易误判的状态。子任务被 fork 后尚未完成时,它还没有可读取的结论;scope 被取消时,未完成任务也可能停留在不可用状态。若任务是在 scope 已取消后 fork 的,甚至不会真正创建执行线程。

因此,排查这类问题时按下面的顺序判断:

  • 先确认调用者是 scope owner;非 owner 线程不能越过结构化并发的访问边界。
  • 确认已经执行 join()。在等待完成前,不要凭一次 state() 结果读取数据。
  • 看到 UNAVAILABLE 时检查取消原因和任务完成时机,不要直接包装成业务异常。
  • 只有 SUCCESS 读取 get(),只有 FAILED 读取 exception()。
StructuredTaskScope join 取消与结果读取边界的结构说明图
图2:join、取消与结果读取边界的结构说明图,不是截图或运行证据。

复查时最容易漏掉的边界

第一,state() 只能说明子任务结果是否可用,不能替代业务状态码;第二,FAILED 表示任务以异常或错误结束,具体原因要从 exception() 取出;第三,try-with-resources 仍然必要,关闭 scope 会处理未完成子任务。若代码需要在取消后保留部分成功结果,也要先判断每个子任务的状态,再决定是否读取。

常见问题

为什么不能直接对每个 Subtask 调用 get?

因为 get() 只适用于 scope owner 在等待完成后读取成功子任务。对未完成、失败或取消后不可用的任务直接读取,无法表达正确的状态边界。

UNAVAILABLE 和 FAILED 有什么区别?

FAILED 已经有明确的异常或错误;UNAVAILABLE 没有可读取的结果或异常,原因可能是尚未完成或被取消。两者的补救动作不同,不能合并处理。

版本声明
本文转载于:17golang原创 如有侵犯,请联系study_golang@163.com删除
Java Currency getNumericCodeAsString 怎样保留货币编号前导零Java Currency getNumericCodeAsString 怎样保留货币编号前导零
上一篇
Java Currency getNumericCodeAsString 怎样保留货币编号前导零
Java Locale.stripExtensions 怎样去掉扩展标签保留基础地区
下一篇
Java Locale.stripExtensions 怎样去掉扩展标签保留基础地区
查看更多
最新文章
查看更多
课程推荐
  • 前端进阶之JavaScript设计模式
    前端进阶之JavaScript设计模式
    设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
    543次学习
  • GO语言核心编程课程
    GO语言核心编程课程
    本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
    516次学习
  • 简单聊聊mysql8与网络通信
    简单聊聊mysql8与网络通信
    如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
    500次学习
  • JavaScript正则表达式基础与实战
    JavaScript正则表达式基础与实战
    在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
    487次学习
  • 从零制作响应式网站—Grid布局
    从零制作响应式网站—Grid布局
    本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
    485次学习
查看更多
AI推荐
  • PubMedQA数据集详解:生物医学问答基准、功能与应用指南
    PubMedQA
    深入了解PubMedQA生物医学问答数据集,涵盖其核心功能、使用方法及在临床决策、药物研发等场景的应用,助力提升NLP模型性能。
    1141次使用
  • H2O EvalGPT:开源LLM大模型评估与排行榜工具
    H2O EvalGPT
    H2O EvalGPT是H2O.ai推出的开源LLM评估平台,提供详细的大模型性能排行榜、行业特定基准测试及A/B测试功能,助您快速选择最适合项目的高性能大语言模型。
    1127次使用
  • LMArena是什么?伯克利AI模型评估平台使用指南与功能解析
    LMArena
    LMArena是加州大学伯克利分校推出的AI模型匿名评测平台。通过盲测投票机制,用户可对比不同大模型回答并生成实时排行榜,助力开发者优化模型及用户选择最佳AI工具。
    1303次使用
  • 斯坦福HELM:大语言模型Holistic Evaluation整体评估框架详解
    HELM
    深入了解斯坦福推出的HELM(Holistic Evaluation of Language Models)大模型评测体系。本文解析其核心功能、安装配置步骤及应用场景,涵盖准确性、公平性、鲁棒性等多维度指标,助力开发者全面优化语言模型性能。
    1242次使用
  • MMBench详解:多模态大模型基准测试、功能特点与使用指南
    MMBench
    MMBench是由上海人工智能实验室等机构联合推出的多模态基准测试平台,提供细粒度能力评估、大规模数据集及VLMEvalKit工具。本文详细介绍其核心功能、安装使用方法及应用场景,助力开发者全面评估多模态模型性能。
    1093次使用
微信登录更方便
  • 密码登录
  • 注册账号
登录即同意 用户协议 和 隐私政策
返回登录
  • 重置密码