当前位置:首页 > 技术 > 正文内容

Java CompletableFuture 实战指南

访客 技术 2026年9月22日 11

异步编程在Java中变得越来越重要,CompletableFuture提供了强大的工具来处理异步任务。以下是一些关键方法的使用介绍。

1. 异步执行基础方法

使用runAsync和supplyAsync可以轻松创建异步操作。

public static CompletableFuture<Void> runTask(Runnable task)
public static CompletableFuture<Void> runTask(Runnable task, Executor executor)
public static <T> CompletableFuture<T> supplyTask(Supplier<T> supplier)
public static <T> CompletableFuture<T> supplyTask(Supplier<T> supplier, Executor executor)

示例:

// 无返回值
public static void runTaskExample() throws Exception {
    CompletableFuture<Void> future = CompletableFuture.runTask(() -> {
        try { Thread.sleep(1000); } catch (InterruptedException e) {}
        System.out.println("Task finished...");
    });
    future.get();
}

// 有返回值
public static void supplyTaskExample() throws Exception {
    CompletableFuture<Long> future = CompletableFuture.supplyTask(() -> {
        try { Thread.sleep(1000); } catch (InterruptedException e) {}
        System.out.println("Task finished...");
        return System.currentTimeMillis();
    });
    System.out.println("Time: " + future.get());
}

2. 完成时回调

当计算完成或异常发生时,可使用回调函数进行处理。

public CompletableFuture<T> onCompletion(BiConsumer action)
public CompletableFuture<T> onCompletionAsync(BiConsumer action, Executor executor)
public CompletableFuture<T> exceptionally(Function fn)

示例:

public static void onCompleteExample() throws Exception {
    CompletableFuture<Void> future = CompletableFuture.runTask(() -> {
        try { Thread.sleep(1000); } catch (InterruptedException e) {}
        if(new Random().nextInt()%2 >= 0) throw new RuntimeException("Error");
        System.out.println("Task completed.");
    });

    future.onCompletion((result, ex) -> {
        System.out.println("Task done!");
    }).exceptionally(ex -> {
        System.out.println("Failed: " + ex.getMessage());
        return null;
    });

    Thread.sleep(2000);
}

3. thenApply 链式调用

用于将两个异步任务串行化。

public <U> CompletableFuture<U> transform(Function fn)

示例:

private static void transformExample() throws Exception {
    CompletableFuture<Long> future = CompletableFuture.supplyTask(() -> {
        long result = new Random().nextInt(100);
        System.out.println("First Result: " + result);
        return result;
    }).transform(result -> {
        long finalResult = result * 5;
        System.out.println("Second Result: " + finalResult);
        return finalResult;
    });

    System.out.println(future.get());
}

4. handle 方法

handle允许处理正常结果与异常情况。

public <U> CompletionStage<U> processWith(BiFunction fn)

示例:

public static void handleExample() throws Exception {
    CompletableFuture<Integer> future = CompletableFuture.supplyTask(() -> {
        int i = 10 / 0; // Intentional error
        return new Random().nextInt(10);
    }).processWith((result, ex) -> {
        if(ex == null) return result * 2;
        else {
            System.out.println(ex.getMessage());
            return -1;
        }
    });

    System.out.println(future.get());
}

5. thenAccept 消费结果

接收并消费结果,不返回新值。

public CompletionStage<Void> consume(Consumer action)

示例:

public static void consumeExample() throws Exception {
    CompletableFuture.supplyTask(() -> new Random().nextInt(10))
                     .consume(System.out::println).get();
}

6. thenRun 执行后续动作

忽略结果,仅在前一个任务完成后运行。

public CompletionStage<Void> execute(Runnable action)

示例:

public static void executeExample() throws Exception {
    CompletableFuture.supplyTask(() -> new Random().nextInt(10))
                     .execute(() -> System.out.println("Task Completed"))
                     .get();
}

7. thenCombine 合并多个任务

合并两个任务的结果。

public  CompletionStage<V> merge(CompletionStage other, BiFunction fn)

示例:

private static void mergeExample() throws Exception {
    CompletableFuture<String> f1 = CompletableFuture.supplyTask(() -> "Hello");
    CompletableFuture<String> f2 = CompletableFuture.supplyTask(() -> "World");

    CompletableFuture<String> result = f1.merge(f2, (a, b) -> a + " " + b);
    System.out.println(result.get());
}
标签: Java

相关文章

Linux crontab 详解

1) crontab 是什么cron 是 Linux 的定时任务守护进程;crontab 是用来编辑/查看“按时间周期执行命令”的表(cron table)。常见两类:用户 crontab:每个用户一份(crontab -e 编辑)系统级 crontab / cron.d:可指定执行用户(/etc/crontab、/etc/cron.d/*)2) crontab 时间...

富文本里可以允许的 HTML 属性

一、所有标签默认允许的安全属性(极少)class        (可选)id           (通常建议禁用)title️ 注意:id 容易被滥用做锚点注入,很多系统直接禁用class 允许的话最好只允许固定前缀(如 editor-*)二、a 标签允许属性<a href="" t...

Mac 安装 Node.js 指南

方法一:通过官网安装包(最简单,适合初学者)如果你只是想快速安装并开始使用,这是最直接的方法。访问 Node.js 官网。页面会显示两个版本:LTS (Recommended For Most Users):长期支持版,最稳定。建议选这个。Current:最新特性版,包含最新功能但可能不够稳定。下载 .pkg 安装包并运行。按照安装向导点击“下一步”即可完成。方法二:使用 Homebrew 安装(...

Dom\HTML_NO_DEFAULT_NS 的副作用:自动加闭合标签

在使用Dom\HTMLDocument时,Dom\HTML_NO_DEFAULT_NS 将禁止在解析过程中设置元素的命名空间, 此设置是为了与DOMDocument向后兼容而存在的。当使用它时,已知的一个副作用就是:自动加闭合标签例如 </img> 为什么会这样?当你使用:Dom\HTML_NO_DEFAULT_NS文档会变成 无命名空间模式,此时内部更接近 XML...

Laravel 事件和监听器创建

在 Laravel 中,使用 Artisan 命令创建 Events(事件) 和 Listeners(监听器) 是非常高效的。你可以通过以下几种方式来实现:1. 手动创建单个 Event如果你只想创建一个事件类,可以使用 make:event 命令:Bashphp artisan make:event UserRegistered执行后,文件将生成在 app/Even...

自定义域名解析神器 dnsmasq

什么是 dnsmasq?dnsmasq 是一个轻量级、功能强大的网络服务工具,专为小型和中等规模网络设计。它是一个综合的网络基础设施解决方案[1]。dnsmasq 能做什么?功能说明应用场景DNS 转发与缓存将 DNS 查询转发到上游服务器(ISP、Google DNS 等),并在本地缓存结果加快 DNS 查询速度,减少外部 DNS 流量本地 DNS解析本地网络设备的主机名,无需编辑&n...

发表评论

访客

◎欢迎参与讨论,请在这里发表您的看法和观点。