CompletableFuture的使用

目录

一、前言

二、概念介绍 

三、自身特性

四、使用方式

1、异步执行一个任务并获取结果

2、异步执行一个任务并处理异常

3、异步执行多个任务并合并结果

4、异步执行多个任务并处理其中一个任务的结果

5、串行执行多个任务

6、 检查异步任务是否执行完成和执行回调

五、使用场景

一、前言

现在大部分的CPU都是多核，我们都知道想要提升我们应用程序的运行效率，就必须得充分利用多核CPU的计算能力；Java为我们提供了大量多线程API，使用它们可以让我们的代码避免同步阻塞，进而达到提升运行效率的目的，CompletableFuture就是其中一个非常强大且重要API，下面我们就来介绍一下CompletableFuture的概念和使用。

二、概念介绍 

CompletableFuture 是 Java 8 中新增的一个异步编程工具类，它是基于 Future 和 CompletionStage 接口构建的，可以与 Java 8 中的 Stream API 配合使用，也能够与 Java 9 中的 Reactive Stream API 进行交互。

主要用于异步执行任务并返回结果，实现异步计算和操作组合。它提供了一种灵活、可组合的方式来实现异步计算，同时也提供了异常处理、取消、超时等特性。在CompletableFuture中，我们可以通过回调函数来处理任务的结果，也可以使用其它方法来组合多个CompletableFuture对象，以构建更复杂的异步操作流水线。

三、自身特性

1. 异步执行：CompletableFuture 可以在新的线程上异步执行计算或操作，从而不会阻塞主线程，提高程序的响应速度。

2. 可组合性：CompletableFuture 的操作可以组合成一个或多个的 CompletableFuture 对象，从而构成复杂的异步计算链。

3. 异常处理：CompletableFuture 可以对异常进行处理，通过 exceptionally() 方法可以捕获计算中的异常并返回默认值。

4. 取消与超时：CompletableFuture 支持取消异步任务，还可以设置超时时间来避免任务的无限等待。

5. 非阻塞式等待：CompletableFuture 提供了非阻塞式的等待方法，如 join() 和 getNow() 方法。

四、使用方式

1、异步执行一个任务并获取结果

通过 CompletableFuture 的静态方法 supplyAsync() 可以异步执行一个任务，返回 CompletableFuture 对象，通过该对象可以获取任务执行的结果。

1.  
   CompletableFuture<String> future = CompletableFuture.supplyAsync(() -> {
2.  
   // 执行一些耗时的操作
3.  
   return "Hello CompletableFuture";
4.  
   });
5.  
   String result = future.get(); // 阻塞等待任务执行完成并获取结果
6.  
   System.out.println(result);

2、异步执行一个任务并处理异常

CompletableFuture 提供了方法 handle() 来处理异步任务执行过程中的异常，它可以处理任务完成时的异常，也可以处理任务执行过程中的异常。

1.  
   CompletableFuture<String> future = CompletableFuture.supplyAsync(() -> {
2.  
   // 执行一些可能会出现异常的操作
3.  
   throw new RuntimeException("Something went wrong");
4.  
   }).handle((result, exception) -> {
5.  
   if (exception != null) {
6.  
   System.out.println("Task failed with exception: " exception);
7.  
   return "default value";
8.  
   } else {
9.  
   return result;
10.  
    }
11.  
    });
12.  
    String result = future.get();
13.  
    System.out.println(result);

3、异步执行多个任务并合并结果

通过 CompletableFuture 的静态方法 allOf() 可以并行执行多个任务，等待所有任务完成后，通过 CompletableFuture.join() 方法合并所有任务的结果。

1.  
   CompletableFuture<String> future1 = CompletableFuture.supplyAsync(() -> "Hello");
2.  
   CompletableFuture<String> future2 = CompletableFuture.supplyAsync(() -> "CompletableFuture");
3.  
   CompletableFuture<String> future3 = CompletableFuture.supplyAsync(() -> "Java");
4.  
    
5.  
   CompletableFuture<Void> combinedFuture = CompletableFuture.allOf(future1, future2, future3);
6.  
   combinedFuture.get();
7.  
    
8.  
   String result = Stream.of(future1, future2, future3)
9.  
   .map(CompletableFuture::join)
10.  
    .collect(Collectors.joining(" "));
11.  
    System.out.println(result);

CompletableFuture 提供了三种方法来处理它们：handle()、whenComplete() 和 exceptionly()。这里就不做详细介绍了，有兴趣的朋友们可以自己去详细了解一下，以下为各种处理方式的比较结果。 

4、异步执行多个任务并处理其中一个任务的结果

通过 CompletableFuture 的静态方法 anyOf() 可以并行执行多个任务，只要有一个任务完成，就会立即返回其结果。

1.  
   CompletableFuture<String> future1 = CompletableFuture.supplyAsync(() -> {
2.  
   try {
3.  
   Thread.sleep(3000);
4.  
   } catch (InterruptedException e) {
5.  
   e.printStackTrace();
6.  
   }
7.  
   return "Result 1";
8.  
   });
9.  
   CompletableFuture<String> future2 = CompletableFuture.supplyAsync(() -> "Result 2");
10.  
    CompletableFuture<String> future3 = CompletableFuture.supplyAsync(() -> "Result 3");
11.  
     
12.  
    CompletableFuture<Object> anyOfFuture = CompletableFuture.anyOf(future1, future2, future3);
13.  
     
14.  
    Object result = anyOfFuture.get();
15.  
    System.out.println(result);

5、串行执行多个任务

通过 CompletableFuture 的方法 thenApply()、thenAccept() 和 thenRun() 可以串行执行多个任务，每个任务在前一个任务完成后才会执行。

1.  
   CompletableFuture<String> future1 = CompletableFuture.supplyAsync(() -> "Hello");
2.  
   CompletableFuture<String> future2 = future1.thenApply(result -> result " CompletableFuture");
3.  
   CompletableFuture<Void> future3 = future2.thenAccept(result -> System

6、 检查异步任务是否执行完成和执行回调

在CompletableFuture中，可以使用isDone()方法来检查异步任务是否已经执行完毕。该方法会返回一个boolean类型的值，表示异步任务是否已经完成。如果异步任务已经完成，则可以通过调用get()方法获取其返回值；如果异步任务还没有完成，则可以通过注册回调函数来等待其完成。

1.  
   CompletableFuture<String> future = CompletableFuture.supplyAsync(() -> {
2.  
   // 异步任务
3.  
   return "Hello, World!";
4.  
   });
5.  
    
6.  
   // 检查异步任务是否已经完成
7.  
   if (future.isDone()) {
8.  
   // 获取异步任务的返回值
9.  
   String result = future.get();
10.  
    System.out.println(result);
11.  
    } else {
12.  
    // 注册回调函数，在异步任务完成时获取其返回值
13.  
    future.thenAccept(result -> {
14.  
    System.out.println(result);
15.  
    });
16.  
    }

五、使用场景

在调用第三方同步API时，我们通常需要等待API返回结果后才能继续执行后续代码，这可能会导致系统的吞吐量较低，影响用户的体验。使用CompletableFuture可以在异步执行API请求的同时，继续执行后续代码，从而提高系统的吞吐量。
下面是一个使用CompletableFuture提高系统吞吐量的示例代码。

1.  
   public class APIService {
2.  
    
3.  
   public String getDataFromAPI(String url) {
4.  
   // 同步请求API
5.  
   String result = request(url);
6.  
   return result;
7.  
   }
8.  
    
9.  
   public CompletableFuture<String> getDataFromAPIAsync(String url) {
10.  
    // 异步请求API
11.  
    CompletableFuture<String> future = CompletableFuture.supplyAsync(() -> request(url));
12.  
    return future;
13.  
    }
14.  
     
15.  
    private String request(String url) {
16.  
    // 请求API并返回结果
17.  
    try {
18.  
    // 打印线程和请求参数，观察结果帮助理解
19.  
    System.out.println(Thread.currentThread().getName());
20.  
    System.out.println(url);
21.  
    // 睡眠模拟请求耗时
22.  
    TimeUnit.SECONDS.sleep(2);
23.  
    } catch (InterruptedException e) {
24.  
    throw new RuntimeException(e);
25.  
    }
26.  
    return "success";
27.  
    }
28.  
    }

在上面的代码中，getDataFromAPI方法是同步请求API的方法，会阻塞后续代码的执行。而getDataFromAPIAsync方法则是使用CompletableFuture异步请求API的方法，不会阻塞后续代码的执行，而是返回一个CompletableFuture对象，代表API请求的异步任务。

我们可以在后续代码中继续执行其他任务，等到异步任务完成后再获取结果。

1.  
   public class Main {
2.  
    
3.  
   public static void main(String[] args) {
4.  
   APIService service = new APIService();
5.  
    
6.  
   CompletableFuture<String> future1 = service.getDataFromAPIAsync("https://api.example.com/data1");
7.  
   CompletableFuture<String> future2 = service.getDataFromAPIAsync("https://api.example.com/data2");
8.  
    
9.  
   // 继续执行其他任务
10.  
    System.out.println("执行其他任务...");
11.  
     
12.  
    // 等待异步任务完成并获取结果
13.  
    String result1 = future1.join();
14.  
    String result2 = future2.join();
15.  
     
16.  
    // 处理结果
17.  
    System.out.println("处理结果...");
18.  
    }
19.  
    }

在上面的代码中，我们使用了CompletableFuture异步请求两个API，并在后续代码中继续执行其他任务。当异步任务完成后，我们使用join方法获取结果，并处理结果。

除了使用join方法获取结果外，使用get方法也可以获取结果。我们还可以使用thenApply、thenAccept、thenCompose等方法对异步任务的结果进行处理。另外，当我们需要等待多个异步任务的完成并获取结果时，可以使用前面介绍的allOf和anyOf方法。

这篇好文章是转载于：学新通技术网