Java 9 新特性 – CompletableFuture API ( 上 )

CompletableFuture 类是在 Java 8 引入的。用于表示一个 Feture 的状态，可以通过设置其值或状态来明确表示 Feture 处于完成状态

说起来特拗口，理解起来就简单了

那个，Java 8 不是引入了并发编程了，对吧。并发编程里有一个概念就是并发执行是否完成了。这个是否完成了是由 java.util.concurrent.CompletionStage 来表示的。然后呢，CompletableFuture 是 CompletionStage 的父类。

如果你对 Java 的并发编程熟悉，那么一定直到，当并发完成时可以支持一个回调，这个回调也是由 CompletableFuture 提供的。

有时候会觉得，一个特性，应该在它出现的时候就比较完善了，直到别人提出了新的思维，才觉得原来还有改进的空间，就比如这个 CompletableFuture 吧

Java 9 竟然还给它添加了一些东西：

1、支持延误和超时(timeout)机制；
2、支持子类化；
3、添加了一些新的工厂方法；

支持延误和超时机制

这两个功能是通过新增两个方法来达成的

方法	说明
completeOnTimeout(T value, long timeout, TimeUnit unit)	如果在指定时间内没完成，则返回一个指定的值
orTimeout(long timeout, TimeUnit unit)	如果在指定的时间内没完成，则抛出一个异常 `TimeoutException`

这两个方法的看起来是差不多的，都是在指定时间内没完成则执行一个动作，只不过前者是返回一个指定的值，后者则直接抛出异常

这两个方法的原型如下

public CompletableFuture<T> completeOnTimeout(T value, long timeout, TimeUnit unit)

public CompletableFuture<T> orTimeout(long timeout, TimeUnit unit)

范例

在我们的工作目录创建一个文件 CompletableFutureTimeoutTester.java 并输入以下内容

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

class CompletableFutureTimeoutTester {

    public static void main(String[] args) {

        try {               
            CompletableFuture<Integer> future = CompletableFuture.supplyAsync(CompletableFutureTimeoutTester::computeEndlessly)
              .orTimeout(1, TimeUnit.SECONDS);

            future.get(); // 显式等待超时
        } catch ( Exception e )
        {
            System.out.println(e);
        }

        try {
            int defaultValue = 7;
            CompletableFuture<Integer> future = CompletableFuture.supplyAsync(CompletableFutureTimeoutTester::computeEndlessly)
            .completeOnTimeout(defaultValue, 1, TimeUnit.SECONDS);

            Integer result = future.get(); // 显式等待超时
            System.out.println(result);
        } catch ( Exception e )
        {
            System.out.println(e);
        }
    }

    private static Integer computeEndlessly() {
        try {
            Thread.sleep(Integer.MAX_VALUE);
        } catch (InterruptedException e) {
            Thread.currentThread().interrupt();
        }

        return 42;
    }
}

运行结果如下

[penglei@ddkk.com java9]$ javac CompletableFutureTimeoutTester.java && java CompletableFutureTimeoutTester
java.util.concurrent.ExecutionException: java.util.concurrent.TimeoutException
7

从运行的结果中可以看到，如果执行超时， orTimeout() 方法直接抛出了一个异常，而 completeOnTimeout() 方法则是返回默认值

17、Java 9 新特性 – CompletableFuture API ( 上 )

支持延误和超时机制

范例