Java 函数式接口怎么在CompletionStage.completeOnTimeout中使用

老婷姑娘_9841

老婷姑娘_9841

2026-11-16

991人浏览

原创

在 completionstage 的超时控制中,直接传入函数式接口作为默认值时,应使用 completablefuture.supplyasync() 配合 ortimeout() 或 completeontimeout()(注:标准 jdk 8+ 中 completeontimeout 仅存在于 completionstage 的扩展实现或特定库如 rxjava,jdk 原生 completablefuture 无此方法,通常用 ortimeout() (jdk 9+) 或 timeout() 结合 completeontimeout 逻辑模拟。若指 jdk 9+ ortimeout(),它不接受函数式接口作为默认值,而是抛出异常。若指类似 completablefuture.completeontimeout(value, timeout, unit) 这种静态辅助方法或自定义逻辑,核心是将函数式接口的结果与超时默认值进行分支处理。这里假设你指的是通过 completablefuture 链式调用实现超时回退,最标准的做法是利用 ortimeout() 捕获超时异常并 fallback,或者使用第三方库如 rxjava 的 timeout() 操作符。鉴于 jdk 原生限制,我们演示如何使用 completablefuture 和 ortimeout() 结合 exceptionally() 来模拟“超时返回默认值”的行为,这通常涉及一个函数式接口 supplier 来生成原始数据。

Java 函数式接口怎么在CompletionStage.completeOnTimeout中使用

如何定义并传递 Supplier 给异步任务

要使用函数式接口,首先需要定义一个 Supplier 或 Callable。在 CompletableFuture 中,我们通过 supplyAsync(supplier) 提交这个接口。如果任务执行时间超过设定阈值,orTimeout() 会中断该阶段并抛出 TimeoutException。为了得到“超时返回默认值”的效果,我们需要在后续节点捕获这个异常。

Java 函数式接口怎么在CompletionStage.completeOnTimeout中使用

import java.util.concurrent.CompletableFuture;
import java.util.concurrent.ExecutionException;
import java.util.concurrent.TimeUnit;

public class TimeoutDemo {
    public static void main(String[] args) throws ExecutionException, InterruptedException {
        // 1. 定义函数式接口 Supplier
        CompletableFuture<string> future = CompletableFuture.supplyAsync(() -> {
            try {
                Thread.sleep(2000); // 模拟耗时操作
                return "Success";
            } catch (InterruptedException e) {
                throw new RuntimeException(e);
            }
        });

        // 2. 设置超时并处理异常以提供默认值
        String result = future
                .orTimeout(1, TimeUnit.SECONDS)
                .exceptionally(ex -> {
                    if (ex.getCause() instanceof java.util.concurrent.TimeoutException) {
                        return "Default Value"; // 超时返回的默认值
                    }
                    throw new RuntimeException(ex);
                })
                .get();

        System.out.println(result);
    }
}</string>

运行上述代码,由于 sleep(2000) 超过了 orTimeout(1, ...) 设置的 1 秒,程序将输出 Default Value。如果修改 sleep 为 500 毫秒,则输出 Success。关键点在于 exceptionally 接收一个 Function,这也是一个函数式接口,用于处理上游失败(包括超时)的情况。

如何在链式调用中组合多个超时策略

当存在多个依赖阶段时,超时控制需要明确作用域。orTimeout() 只作用于调用它之前的那一段异步计算。如果在 thenApply 之后再次调用 orTimeout(),它将针对新的计算阶段。我们可以利用这一点,为不同的函数式接口步骤设置不同的超时容忍度,并通过 handle() 或 exceptionally() 统一收集结果。

Build Java agent transport gateways with Atmosphere
Build Java agent transport gateways with Atmosphere

使用Atmosphere构建通过WebSocket、SSE、gRPC、WebTransport、MCP、A2A和AG-UI流传输的JVM代理网关,并带有治理钩子。

下载

Java 函数式接口怎么在CompletionStage.completeOnTimeout中使用

import java.util.concurrent.CompletableFuture;
import java.util.concurrent.ExecutionException;
import java.util.concurrent.TimeUnit;

public class MultiStageTimeout {
    public static void main(String[] args) throws ExecutionException, InterruptedException {
        // 第一阶段:快速检查
        CompletableFuture<boolean> checkFuture = CompletableFuture.supplyAsync(() -> {
            Thread.sleep(100); 
            return true;
        });

        // 第二阶段:慢速计算,独立超时
        CompletableFuture<string> slowFuture = checkFuture.thenCompose(valid -> {
            if (!valid) return CompletableFuture.completedFuture("Invalid");
            return CompletableFuture.supplyAsync(() -> {
                Thread.sleep(2000); // 慢操作
                return "Data";
            });
        });

        // 应用超时到第二阶段
        String finalResult = slowFuture
                .orTimeout(1, TimeUnit.SECONDS)
                .handle((res, ex) -> {
                    if (ex != null && ex.getCause() instanceof java.util.concurrent.TimeoutException) {
                        return "TIMEOUT_FALLBACK";
                    }
                    return res;
                })
                .get();

        System.out.println(finalResult);
    }
}</string></boolean>

在这个例子中,checkFuture 很快完成,但 slowFuture 中的异步任务会触发超时。handle() 方法同样接受两个参数(结果和异常),是一个强大的函数式接口 BiFunction。它允许我们在不中断流的情况下同时访问成功值和失败原因,从而灵活地决定超时时的返回值。最终输出将是 TIMEOUT_FALLBACK。

当 Supplier 内部抛出非超时异常时会发生什么

如果 Supplier 内部抛出的不是 TimeoutException,例如 RuntimeException,orTimeout() 不会拦截它,而是将其原样传递给 exceptionally() 或 handle()。此时 ex.getCause() 将是那个运行时异常。开发者必须区分这两种情况,否则可能会错误地将业务逻辑错误当作超时处理,返回默认的“安全”值,从而掩盖真正的 Bug。建议在 exceptionally 中记录日志或重新抛出非超时异常,以确保生产环境的可观测性。

Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

java

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
java
java

Java是一个通用术语,用于表示Java软件及其组件,包括“Java运行时环境 (JRE)”、“Java虚拟机 (JVM)”以及“插件”。php中文网还为大家带了Java相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

2023.06.15

12717

6

java正则表达式语法
java正则表达式语法

java正则表达式语法是一种模式匹配工具,它非常有用,可以在处理文本和字符串时快速地查找、替换、验证和提取特定的模式和数据。本专题提供java正则表达式语法的相关文章、下载和专题,供大家免费下载体验。

2023.07.05

9802

9

java自学难吗
java自学难吗

Java自学并不难。Java语言相对于其他一些编程语言而言,有着较为简洁和易读的语法,本专题为大家提供java自学难吗相关的文章,大家可以免费体验。

2023.07.31

8332

8

java配置jdk环境变量
java配置jdk环境变量

Java是一种广泛使用的高级编程语言,用于开发各种类型的应用程序。为了能够在计算机上正确运行和编译Java代码,需要正确配置Java Development Kit(JDK)环境变量。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.08.01

1344

3

java保留两位小数
java保留两位小数

Java是一种广泛应用于编程领域的高级编程语言。在Java中,保留两位小数是指在进行数值计算或输出时,限制小数部分只有两位有效数字,并将多余的位数进行四舍五入或截取。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.08.02

1068

3

java基本数据类型
java基本数据类型

java基本数据类型有:1、byte;2、short;3、int;4、long;5、float;6、double;7、char;8、boolean。本专题为大家提供java基本数据类型的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.02

1596

5

java有什么用
java有什么用

java可以开发应用程序、移动应用、Web应用、企业级应用、嵌入式系统等方面。本专题为大家提供java有什么用的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.02

3329

5

java在线网站
java在线网站

Java在线网站是指提供Java编程学习、实践和交流平台的网络服务。近年来,随着Java语言在软件开发领域的广泛应用,越来越多的人对Java编程感兴趣,并希望能够通过在线网站来学习和提高自己的Java编程技能。php中文网给大家带来了相关的视频、教程以及文章,欢迎大家前来学习阅读和下载。

2023.08.03

20551

3

配置java环境变量
配置java环境变量

配置Java环境变量是为了让操作系统能够识别和使用Java的相关命令和功能。本专题为大家提供配置java环境变量相关文章,帮助大家解决问题。

2023.08.03

1435

8

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
dev.java 官方:Learn Java
dev.java 官方:Learn Java

共0课时 | 0人学习

Java JDBC数据库连接官方教程
Java JDBC数据库连接官方教程

共0课时 | 0人学习