是否CompletionStage总是将异常包装在CompletionException中？

Question

该CompletionStage的Javadoc状态：

[…]如果阶段的计算由于（未经检查的）异常或错误而突然终止，则所有需要完成该过程的从属阶段也会异常完成，并且CompletionException将异常作为其原因。

看到异常完成总是将异常包装在CompletionException为什么中exceptionally()，whenComplete()并且handle()将异常表示为Throwable而不是CompletionException？

这很重要，因为它可以防止人们直接在这些方法中引发异常。

这些方法是否可能收到除以外的其他异常CompletionException？还是我可以安全地强制使用这种类型的演员？

（我在本地运行了一些测试，并浏览了CompletableFuture源代码，乍看之下，我不知道如何抛出任何其他类型的异常。）

Answer 1

这些方法是否可能收到除以外的其他异常 CompletionException？

是的，有可能，并且您不应该CompletionException未经instanceof检查（或检查使用情况）而投身到。

举个例子

CompletableFuture<Void> root = new CompletableFuture<>();
root.whenComplete((v, t) -> {
    System.out.println(t.getClass()); // class java.io.IOException
});
root.completeExceptionally(new IOException("blow it up"));

whenComplete将收到IOException而不是CompletionException包装它。同样的行为适用于exceptionally和handle。

阶段的计算在Javadoc中定义：

由一个阶段执行的计算可被表达为一个Function，
Consumer或Runnable根据（使用名称，包括应用，接受或运行，分别方法）是否需要参数和/或产生的结果。

我相信这句话

如果阶段的计算由于（未经检查的）异常或错误而突然终止

指的是其中的一个Function#apply，Consumer#accept或Runnable#run方法突然终止，因为一个的抛出的异常，而不是因为一个阶段格外通过一些其他机制完成。

另请注意，Javadoc说

该界面未定义用于初始创建，强制正常或 异常
强制完成，探查完成状态或结果或等待阶段完成的方法。的实现CompletionStage可以酌情提供实现这种效果的手段

换句话说，该接口允许实现在不突然终止任何计算的情况下出色地完成阶段。我认为这允许新的行为。

如果我们从以前扩展我的例子

CompletableFuture<Void> root = new CompletableFuture<>();
CompletableFuture<Void> child = root.whenComplete((v, t) -> {
    System.out.println(t.getClass()); // class java.io.Exception
});
child.whenComplete((v, t) -> {
    System.out.println(t.getClass()); // class java.util.concurrent.CompletionException
});
root.completeExceptionally(new IOException("blow it up"));

您会注意到随附的完成文件会child收到CompletionException原始文件的包装IOException。从Javadoc来看，这对我来说并不明显

返回一个新的，CompletionStage具有与该阶段 相同的 结果或 异常

总而言之，似乎来自a的原始异常completeExceptionally被传递给直接的从属，而从属的从属却收到一个封闭的CompletionException。