资讯专栏INFORMATION COLUMN

猫头鹰的深夜翻译:使用JAVA CompletableFuture的20例子

AZmake / 3781人阅读

摘要:这个例子想要说明两个事情中以为结尾的方法将会异步执行默认情况下即指没有传入的情况下,异步执行会使用实现,该线程池使用一个后台线程来执行任务。这个例子展示了如何使用一个固定大小的线程池来实现大写操作。

前言

这篇博客回顾JAVA8的CompletionStageAPI以及其在JAVA库中的标准实现CompletableFuture。将会通过几个例子来展示API的各种行为。

因为CompletableFutureCompletionInterface接口的实现,所以我们首先要了解该接口的契约。它代表某个同步或异步计算的一个阶段。你可以把它理解为是一个为了产生有价值最终结果的计算的流水线上的一个单元。这意味着多个ComletionStage指令可以链接起来从而一个阶段的完成可以触发下一个阶段的执行。

除了实现了CompletionStage接口,Completion还继承了Future,这个接口用于实现一个未开始的异步事件。因为能够显式的完成Future,所以取名为CompletableFuture

1.新建一个完成的CompletableFuture

这个简单的示例中创建了一个已经完成的预先设置好结果的CompletableFuture。通常作为计算的起点阶段。

</>复制代码

  1. static void completedFutureExample() {
  2. CompletableFuture cf = CompletableFuture.completedFuture("message");
  3. assertTrue(cf.isDone());
  4. assertEquals("message", cf.getNow(null));
  5. }

getNow方法会返回完成后的结果(这里就是message),如果还未完成,则返回传入的默认值null

2.运行一个简单的异步stage

下面的例子解释了如何创建一个异步运行Runnable的stage。

</>复制代码

  1. static void runAsyncExample() {
  2. CompletableFuture cf = CompletableFuture.runAsync(() -> {
  3. assertTrue(Thread.currentThread().isDaemon());
  4. randomSleep();
  5. });
  6. assertFalse(cf.isDone());
  7. sleepEnough();
  8. assertTrue(cf.isDone());
  9. }

这个例子想要说明两个事情:

CompletableFuture中以Async为结尾的方法将会异步执行

默认情况下(即指没有传入Executor的情况下),异步执行会使用ForkJoinPool实现,该线程池使用一个后台线程来执行Runnable任务。注意这只是特定于CompletableFuture实现,其它的CompletableStage实现可以重写该默认行为。

3.将方法作用于前一个Stage

下面的例子引用了第一个例子中已经完成的CompletableFuture,它将引用生成的字符串结果并将该字符串大写。

</>复制代码

  1. static void thenApplyExample() {
  2. CompletableFuture cf = CompletableFuture.completedFuture("message").thenApply(s -> {
  3. assertFalse(Thread.currentThread().isDaemon());
  4. return s.toUpperCase();
  5. });
  6. assertEquals("MESSAGE", cf.getNow(null));
  7. }

这里的关键词是thenApply

then是指在当前阶段正常执行完成后(正常执行是指没有抛出异常)进行的操作。在本例中,当前阶段已经完成并得到值message

Apply是指将一个Function作用于之前阶段得出的结果

Function是阻塞的,这意味着只有当大写操作执行完成之后才会执行getNow()方法。

4.异步的的将方法作用于前一个Stage

通过在方法后面添加Async后缀,该CompletableFuture链将会异步执行(使用ForkJoinPool.commonPool())

</>复制代码

  1. static void thenApplyAsyncExample() {
  2. CompletableFuture cf = CompletableFuture.completedFuture("message").thenApplyAsync(s -> {
  3. assertTrue(Thread.currentThread().isDaemon());
  4. randomSleep();
  5. return s.toUpperCase();
  6. });
  7. assertNull(cf.getNow(null));
  8. assertEquals("MESSAGE", cf.join());
  9. }
使用一个自定义的Executor来异步执行该方法

异步方法的一个好处是可以提供一个Executor来执行CompletableStage。这个例子展示了如何使用一个固定大小的线程池来实现大写操作。

</>复制代码

  1. static ExecutorService executor = Executors.newFixedThreadPool(3, new ThreadFactory() {
  2. int count = 1;
  3. @Override
  4. public Thread newThread(Runnable runnable) {
  5. return new Thread(runnable, "custom-executor-" + count++);
  6. }
  7. });
  8. static void thenApplyAsyncWithExecutorExample() {
  9. CompletableFuture cf = CompletableFuture.completedFuture("message").thenApplyAsync(s -> {
  10. assertTrue(Thread.currentThread().getName().startsWith("custom-executor-"));
  11. assertFalse(Thread.currentThread().isDaemon());
  12. randomSleep();
  13. return s.toUpperCase();
  14. }, executor);
  15. assertNull(cf.getNow(null));
  16. assertEquals("MESSAGE", cf.join());
  17. }
6.消费(Consume)前一个Stage的结果

如果下一个Stage接收了当前Stage的结果但是在计算中无需返回值(比如其返回值为void),那么它将使用方法thenAccept并传入一个Consumer接口。

</>复制代码

  1. static void thenAcceptExample() {
  2. StringBuilder result = new StringBuilder();
  3. CompletableFuture.completedFuture("thenAccept message")
  4. .thenAccept(s -> result.append(s));
  5. assertTrue("Result was empty", result.length() > 0);
  6. }

Consumer将会同步执行,所以我们无需在返回的CompletableFuture上执行join操作。

7.异步执行Comsume

同样,使用Asyn后缀实现:

</>复制代码

  1. static void thenAcceptAsyncExample() {
  2. StringBuilder result = new StringBuilder();
  3. CompletableFuture cf = CompletableFuture.completedFuture("thenAcceptAsync message")
  4. .thenAcceptAsync(s -> result.append(s));
  5. cf.join();
  6. assertTrue("Result was empty", result.length() > 0);
  7. }
8.计算出现异常时

我们现在来模拟一个出现异常的场景。为了简洁性,我们还是将一个字符串大写,但是我们会模拟延时进行该操作。我们会使用thenApplyAsyn(Function, Executor),第一个参数是大写转化方法,第二个参数是一个延时executor,它会延时一秒钟再将操作提交给ForkJoinPool

</>复制代码

  1. static void completeExceptionallyExample() {
  2. CompletableFuture cf = CompletableFuture.completedFuture("message").thenApplyAsync(String::toUpperCase,
  3. CompletableFuture.delayedExecutor(1, TimeUnit.SECONDS));
  4. CompletableFuture exceptionHandler = cf.handle((s, th) -> { return (th != null) ? "message upon cancel" : ""; });
  5. cf.completeExceptionally(new RuntimeException("completed exceptionally"));
  6. assertTrue("Was not completed exceptionally", cf.isCompletedExceptionally());
  7. try {
  8. cf.join();
  9. fail("Should have thrown an exception");
  10. } catch(CompletionException ex) { // just for testing
  11. assertEquals("completed exceptionally", ex.getCause().getMessage());
  12. }
  13. assertEquals("message upon cancel", exceptionHandler.join());
  14. }

首先,我们新建了一个已经完成并带有返回值messageCompletableFuture对象。然后我们调用thenApplyAsync方法,该方法会返回一个新的CompletableFuture。这个方法用异步的方式执行大写操作。这里还展示了如何使用delayedExecutor(timeout, timeUnit)方法来延时异步操作。

然后我们创建了一个handler stage,exceptionHandler,这个阶段会处理一切异常并返回另一个消息message upon cancel

最后,我们显式的完成第二个阶段并抛出异常,它会导致进行大写操作的阶段抛出CompletionException。它还会触发handler阶段。

</>复制代码

  1. API补充:
    CompletableFuture handle(BiFunction fn)
    返回一个新的CompletionStage,无论之前的Stage是否正常运行完毕。传入的参数包括上一个阶段的结果和抛出异常。
9.取消计算

和计算时异常处理很相似,我们可以通过Future接口中的cancel(boolean mayInterruptIfRunning)来取消计算。

</>复制代码

  1. static void cancelExample() {
  2. CompletableFuture cf = CompletableFuture.completedFuture("message").thenApplyAsync(String::toUpperCase,
  3. CompletableFuture.delayedExecutor(1, TimeUnit.SECONDS));
  4. CompletableFuture cf2 = cf.exceptionally(throwable -> "canceled message");
  5. assertTrue("Was not canceled", cf.cancel(true));
  6. assertTrue("Was not completed exceptionally", cf.isCompletedExceptionally());
  7. assertEquals("canceled message", cf2.join());
  8. }

</>复制代码

  1. API补充
    public CompletableFuture exceptionally(Function fn)
    返回一个新的CompletableFuture,如果出现异常,则为该方法中执行的结果,否则就是正常执行的结果。
10.将Function作用于两个已完成Stage的结果之一

下面的例子创建了一个CompletableFuture对象并将Function作用于已完成的两个Stage中的任意一个(没有保证哪一个将会传递给Function)。这两个阶段分别如下:一个将字符串大写,另一个小写。

</>复制代码

  1. static void applyToEitherExample() {
  2. String original = "Message";
  3. CompletableFuture cf1 = CompletableFuture.completedFuture(original)
  4. .thenApplyAsync(s -> delayedUpperCase(s));
  5. CompletableFuture cf2 = cf1.applyToEither(
  6. CompletableFuture.completedFuture(original).thenApplyAsync(s -> delayedLowerCase(s)),
  7. s -> s + " from applyToEither");
  8. assertTrue(cf2.join().endsWith(" from applyToEither"));
  9. }

</>复制代码

  1. public CompletableFuture applyToEitherAsync(CompletionStage other,Function fn)
    返回一个全新的CompletableFuture,包含着this或是other操作完成之后,在二者中的任意一个执行fn
11.消费两个阶段的任意一个结果

和前一个例子类似,将Function替换为Consumer

</>复制代码

  1. static void acceptEitherExample() {
  2. String original = "Message";
  3. StringBuilder result = new StringBuilder();
  4. CompletableFuture cf = CompletableFuture.completedFuture(original)
  5. .thenApplyAsync(s -> delayedUpperCase(s))
  6. .acceptEither(CompletableFuture.completedFuture(original).thenApplyAsync(s -> delayedLowerCase(s)),
  7. s -> result.append(s).append("acceptEither"));
  8. cf.join();
  9. assertTrue("Result was empty", result.toString().endsWith("acceptEither"));
  10. }
12.在两个阶段都完成后运行Runnable

注意这里的两个Stage都是同步运行的,第一个stage将字符串转化为大写之后,第二个stage将其转化为小写。

</>复制代码

  1. static void runAfterBothExample() {
  2. String original = "Message";
  3. StringBuilder result = new StringBuilder();
  4. CompletableFuture.completedFuture(original).thenApply(String::toUpperCase).runAfterBoth(
  5. CompletableFuture.completedFuture(original).thenApply(String::toLowerCase),
  6. () -> result.append("done"));
  7. assertTrue("Result was empty", result.length() > 0);
  8. }
13.用Biconsumer接收两个stage的结果

Biconsumer支持同时对两个Stage的结果进行操作。

</>复制代码

  1. static void thenAcceptBothExample() {
  2. String original = "Message";
  3. StringBuilder result = new StringBuilder();
  4. CompletableFuture.completedFuture(original).thenApply(String::toUpperCase).thenAcceptBoth(
  5. CompletableFuture.completedFuture(original).thenApply(String::toLowerCase),
  6. (s1, s2) -> result.append(s1 + s2));
  7. assertEquals("MESSAGEmessage", result.toString());
  8. }
14.将Bifunction同时作用于两个阶段的结果

如果CompletableFuture想要合并两个阶段的结果并且返回值,我们可以使用方法thenCombine。这里的计算流都是同步的,所以最后的getNow()方法会获得最终结果,即大写操作和小写操作的结果的拼接。

</>复制代码

  1. static void thenCombineExample() {
  2. String original = "Message";
  3. CompletableFuture cf = CompletableFuture.completedFuture(original).thenApply(s -> delayedUpperCase(s))
  4. .thenCombine(CompletableFuture.completedFuture(original).thenApply(s -> delayedLowerCase(s)),
  5. (s1, s2) -> s1 + s2);
  6. assertEquals("MESSAGEmessage", cf.getNow(null));
  7. }
15.异步将Bifunction同时作用于两个阶段的结果

和之前的例子类似,只是这里用了不同的方法:即两个阶段的操作都是异步的。那么thenCombine也会异步执行,及时它没有Async后缀。

</>复制代码

  1. static void thenCombineAsyncExample() {
  2. String original = "Message";
  3. CompletableFuture cf = CompletableFuture.completedFuture(original)
  4. .thenApplyAsync(s -> delayedUpperCase(s))
  5. .thenCombine(CompletableFuture.completedFuture(original).thenApplyAsync(s -> delayedLowerCase(s)),
  6. (s1, s2) -> s1 + s2);
  7. assertEquals("MESSAGEmessage", cf.join());
  8. }
16.Compose CompletableFuture

我们可以使用thenCompose来完成前两个例子中的操作。

</>复制代码

  1. static void thenComposeExample() {
  2. String original = "Message";
  3. CompletableFuture cf = CompletableFuture.completedFuture(original).thenApply(s -> delayedUpperCase(s))
  4. .thenCompose(upper -> CompletableFuture.completedFuture(original).thenApply(s -> delayedLowerCase(s))
  5. .thenApply(s -> upper + s));
  6. assertEquals("MESSAGEmessage", cf.join());
  7. }
17.当多个阶段中有有何一个完成,即新建一个完成阶段

</>复制代码

  1. static void anyOfExample() {
  2. StringBuilder result = new StringBuilder();
  3. List messages = Arrays.asList("a", "b", "c");
  4. List futures = messages.stream()
  5. .map(msg -> CompletableFuture.completedFuture(msg).thenApply(s -> delayedUpperCase(s)))
  6. .collect(Collectors.toList());
  7. CompletableFuture.anyOf(futures.toArray(new CompletableFuture[futures.size()])).whenComplete((res, th) -> {
  8. if(th == null) {
  9. assertTrue(isUpperCase((String) res));
  10. result.append(res);
  11. }
  12. });
  13. assertTrue("Result was empty", result.length() > 0);
  14. }
18.当所有的阶段完成,新建一个完成阶段

</>复制代码

  1. static void allOfExample() {
  2. StringBuilder result = new StringBuilder();
  3. List messages = Arrays.asList("a", "b", "c");
  4. List futures = messages.stream()
  5. .map(msg -> CompletableFuture.completedFuture(msg).thenApply(s -> delayedUpperCase(s)))
  6. .collect(Collectors.toList());
  7. CompletableFuture.allOf(futures.toArray(new CompletableFuture[futures.size()]))
  8. .whenComplete((v, th) -> {
  9. futures.forEach(cf -> assertTrue(isUpperCase(cf.getNow(null))));
  10. result.append("done");
  11. });
  12. assertTrue("Result was empty", result.length() > 0);
  13. }
19.当所有阶段完成以后,新建一个异步完成阶段

</>复制代码

  1. static void allOfAsyncExample() {
  2. StringBuilder result = new StringBuilder();
  3. List messages = Arrays.asList("a", "b", "c");
  4. List futures = messages.stream()
  5. .map(msg -> CompletableFuture.completedFuture(msg).thenApplyAsync(s -> delayedUpperCase(s)))
  6. .collect(Collectors.toList());
  7. CompletableFuture allOf = CompletableFuture.allOf(futures.toArray(new CompletableFuture[futures.size()]))
  8. .whenComplete((v, th) -> {
  9. futures.forEach(cf -> assertTrue(isUpperCase(cf.getNow(null))));
  10. result.append("done");
  11. });
  12. allOf.join();
  13. assertTrue("Result was empty", result.length() > 0);
  14. }
20.真实场景

下面展示了一个实践CompletableFuture的场景:

先通过调用cars()方法异步获得Car列表。它将会返回一个CompletionStage>cars()方法应当使用一个远程的REST端点来实现。

我们将该Stage和另一个Stage组合,另一个Stage会通过调用rating(manufactureId)来异步获取每辆车的评分。

当所有的Car对象都填入评分后,我们调用allOf()来进入最终Stage,它将在这两个阶段完成后执行

在最终Stage上使用whenComplete(),打印出车辆的评分。

</>复制代码

  1. cars().thenCompose(cars -> {
  2. List updatedCars = cars.stream()
  3. .map(car -> rating(car.manufacturerId).thenApply(r -> {
  4. car.setRating(r);
  5. return car;
  6. })).collect(Collectors.toList());
  7. CompletableFuture done = CompletableFuture
  8. .allOf(updatedCars.toArray(new CompletableFuture[updatedCars.size()]));
  9. return done.thenApply(v -> updatedCars.stream().map(CompletionStage::toCompletableFuture)
  10. .map(CompletableFuture::join).collect(Collectors.toList()));
  11. }).whenComplete((cars, th) -> {
  12. if (th == null) {
  13. cars.forEach(System.out::println);
  14. } else {
  15. throw new RuntimeException(th);
  16. }
  17. }).toCompletableFuture().join();
参考资料

</>复制代码

  1. Java CompletableFuture 详解
    Guide To CompletableFuture


想要了解更多开发技术,面试教程以及互联网公司内推,欢迎关注我的微信公众号!将会不定期的发放福利哦~

文章版权归作者所有,未经允许请勿转载,若此文章存在违规行为,您可以联系管理员删除。

转载请注明本文地址:https://www.ucloud.cn/yun/68632.html

相关文章

  • 头鹰深夜翻译Java 10JEP 286-局部变量类型推断

    摘要:在此基础上又向前迈进了一步局部变量类型推断允许开发人员跳过局部变量的类型声明局部变量是指在方法定义,初始化块,循环和其它的如代码块,会推断该局部变量的类型。 前言 之前面试的时候问了我是否了解JDK10的变化,一时回答不出来,所以只回答了JDK8中的函数式编程和流编程。今天看到这篇讲JAVA10的文章,顺便了解一下。 正文 JAVA10的所有新特性请参考这里。在所有的JEP中,JEP-...

    chavesgu 评论0 收藏0
  • 头鹰深夜翻译:Volatile原子性, 可见性和有序性

    摘要:有可能一个线程中的动作相对于另一个线程出现乱序。当实际输出取决于线程交错的结果时,这种情况被称为竞争条件。这里的问题在于代码块不是原子性的,而且实例的变化对别的线程不可见。这种不能同时在多个线程上执行的部分被称为关键部分。 为什么要额外写一篇文章来研究volatile呢?是因为这可能是并发中最令人困惑以及最被误解的结构。我看过不少解释volatile的博客,但是大多数要么不完整,要么难...

    Lionad-Morotar 评论0 收藏0
  • 头鹰深夜翻译:核心JAVA并发(二)

    摘要:前言上一篇文章请参考猫头鹰的深夜翻译核心并发一安全发布发布一个对象是指该对象的引用对当前的域之外也可见比如,从方法中获取一个引用。任务的功能性接口表示一个没有返回值的任务表示一个包含返回值的计算。 前言 上一篇文章请参考猫头鹰的深夜翻译:核心JAVA并发(一) 安全发布 发布一个对象是指该对象的引用对当前的域之外也可见(比如,从getter方法中获取一个引用)。要确保一个对象被安全的发...

    Pink 评论0 收藏0
  • 头鹰深夜翻译Java WeakHashMap

    摘要:本文简介类概览类构造器总结类构造方法类使用举例类概览是一个实现了接口,并且键为型的哈希表。中的条目不再被正常使用时,会被自动删除。它的键值均支持。和绝大多数的集合类一样,这个类不是同步的。 本文简介 WeakHashMap类概览 WeakHashMap类构造器总结 WeakHashMap类构造方法 WeakHasjMap类使用举例 1. WeakHashMap类概览 Wea...

    BothEyes1993 评论0 收藏0
  • 头鹰深夜翻译:JDK Vs. JRE Vs. JVM之间区别

    摘要:什么是为执行字节码提供一个运行环境。它的实现主要包含三个部分,描述实现规格的文档,具体实现和满足要求的计算机程序以及实例具体执行字节码。该类先被转化为一组字节码并放入文件中。字节码校验器通过字节码校验器检查格式并找出非法代码。 什么是Java Development Kit (JDK)? JDK通常用来开发Java应用和插件。基本上可以认为是一个软件开发环境。JDK包含Java Run...

    blair 评论0 收藏0

发表评论

0条评论

最新活动
阅读需要支付1元查看
<