java.util.concurrent之CompletableFuture与CompletionStage

CompletableFuture与CompletionStage

• CompletionStage是一个接口，定义了一系列对任务执行完成后的处理策略
• 接口大致分为三大类型

1. 纯消费者模型, 对任务的执行结果进行消费

/*返回一个新的CompletionStage，当此阶段正常完成时，将以该阶段的结果作为提供的操作的参数执行。*/
public CompletionStage<Void> thenAccept(Consumer<? super T> action);

/*异步执行, 下同...*/
public CompletionStage<Void> thenAcceptAsync(Consumer<? super T> action);

/*指定执行器异步执行, 下同...*/
public CompletionStage<Void> thenAcceptAsync(Consumer<? super T> action, Executor executor);

2. 有返回值，对任务结果进行加工处理

/*返回一个新的CompletionStage，当此阶段正常完成时，将以该阶段的结果作为所提供函数的参数执行。*/
public <U> CompletionStage<U> thenApply(Function<? super T,? extends U> fn);

3. 无返回值, 仅在任务完成之后，进行下一步动作

/*返回一个新的CompletionStage，当此阶段正常完成时，使用此阶段的默认异步执行工具执行给定的操作。*/
public CompletionStage<Void> thenRun(Runnable action);

CompletableFuture为CompletionStage的具体实现

1. CompletableFuture的实例方式

// public static <U> CompletableFuture<U> completedFuture(U value)
// 通过接受一个固定值，实例一个CompletableFuture对象
CompletableFuture<String> future = CompletableFuture.completedFuture("ABC");
// 通过CompletionStage接口的thenAccept
//打印输出 ABC
future.thenAccept(System.out:println);

// public static <U> CompletableFuture<U> supplyAsync(Supplier<U> supplier)
// 异步执行逻辑
CompletableFuture<String> future2 = CompletableFuture.supplyAsync(() -> {
	//doSomething();  返回逻辑处理结果
	return "D";
});
// 通过CompletionStage接口的thenAccept, 对逻辑结果进行处理
//打印输出 D
future2.thenAccept(System.out:println);

// public static CompletableFuture<Void> runAsync(Runnable runnable);
// 异步执行逻辑无返回值
CompletableFuture<String> future3 = CompletableFuture.runAsync(() -> doSomething1());
future3.thenRunAsync(() -> doSomething2()).thenRunAsync(() -> doSomething3());
// 控制异步任务执行顺序 doSomething1() ==> doSomething2() ==> doSomething3()

// public static CompletableFuture<Object> anyOf(CompletableFuture<?>... cfs)
// 接收一个CompletableFuture数组, 任意完成一个任务就返回(谁先执行完谁先返回)
CompletableFuture<Object> future4 = CompletableFuture.anyOf(future, future2);
// 打印输出ABC 或 D
future4.thenAccept(System.out:println);


// public static CompletableFuture<Void> allOf(CompletableFuture<?>... cfs)
// 所有任务都执行完成后，返回结果 join()方法将阻塞线程
CompletableFuture<Object> future5 = CompletableFuture.allOf(future, future2).join();

2. 进阶用法

        CompletableFuture.anyOf(CompletableFuture.supplyAsync(() -> 1), CompletableFuture.supplyAsync(() -> 2)) //随机返回1或2
                .thenCombineAsync(CompletableFuture.supplyAsync(() -> 3), (a, b) -> {
                    // a 为上一步执行结果, anyOf由于是多个任务返回值不确定 因此是Object类型
                    // b 为thenCombine中执行结果
                    return (int) a + b;             // 结果 4 或 5
                }).thenApply(c -> c * 100)          //结果400 或 500
                .thenAccept(System.out::println);   //打印400 或 500