docs: improve wording of README and javadoc 📚

Author: oldratlee

README.md

@@ -1,10 +1,10 @@
 # <div align="center"><a href="#dummy"><img src="https://github.com/foldright/cffu/assets/1063891/124658cd-025f-471e-8da1-7eea0e482915" alt="🦝 CompletableFuture-Fu(CF-Fu)"></a></div>
 
 <p align="center">
-<a href="https://github.com/foldright/cffu/actions/workflows/fast_ci.yaml"><img src="https://img.shields.io/github/actions/workflow/status/foldright/cffu/fast_ci.yaml?branch=main&logo=github&logoColor=white&label=fast ci" alt="Fast CI - GH Workflow Build Status"></a>
-<a href="https://github.com/foldright/cffu/actions/workflows/ci.yaml"><img src="https://img.shields.io/github/actions/workflow/status/foldright/cffu/ci.yaml?branch=main&logo=github&logoColor=white&label=strong ci" alt="Strong CI - GH Workflow Build Status"></a>
+<a href="https://github.com/foldright/cffu/actions/workflows/fast_ci.yaml"><img src="https://img.shields.io/github/actions/workflow/status/foldright/cffu/fast_ci.yaml?branch=main&logo=github&logoColor=white&label=fast%20ci" alt="Fast Build CI"></a>
+<a href="https://github.com/foldright/cffu/actions/workflows/ci.yaml"><img src="https://img.shields.io/github/actions/workflow/status/foldright/cffu/ci.yaml?branch=main&logo=github&logoColor=white&label=strong%20ci" alt="Strong Build CI"></a>
 <a href="https://app.codecov.io/gh/foldright/cffu/tree/main"><img src="https://img.shields.io/codecov/c/github/foldright/cffu/main?logo=codecov&logoColor=white" alt="Codecov"></a>
-<a href="https://qodana.cloud/projects/A61Yy"><img src="https://img.shields.io/github/actions/workflow/status/foldright/cffu/qodana_code_quality.yml?branch=main&logo=jetbrains&logoColor=white&label=qodana" alt="Qodana - GH Workflow Build Status"></a>
+<a href="https://qodana.cloud/projects/A61Yy"><img src="https://img.shields.io/github/actions/workflow/status/foldright/cffu/qodana_code_quality.yml?branch=main&logo=jetbrains&logoColor=white&label=qodana" alt="Qodana Code Inspections"></a>
 <a href="https://openjdk.java.net/"><img src="https://img.shields.io/badge/Java-8+-339933?logo=openjdk&logoColor=white" alt="Java support"></a>
 <a href="https://www.apache.org/licenses/LICENSE-2.0.html"><img src="https://img.shields.io/github/license/foldright/cffu?color=4D7A97&logo=apache" alt="License"></a>
 <a href="https://foldright.io/api-docs/cffu/"><img src="https://img.shields.io/github/release/foldright/cffu?label=javadoc&color=339933&logo=read-the-docs&logoColor=white" alt="Javadocs"></a>
@@ -472,31 +472,52 @@ public class ConcurrencyStrategyDemo {
 
 ### 2.4 支持直接运行多个`Action`，而不是要先包装成`CompletableFuture`
 
-`CompletableFuture`的`allOf/anyOf`方法输入的是`CompletableFuture`，当业务直接有要编排业务逻辑方法时仍然需要先包装成`CompletableFuture`再运行：
+`CompletableFuture`的`allOf/anyOf`方法输入的是`CompletableFuture`；当业务直接有要编排业务逻辑方法时，仍然需要先包装成`CompletableFuture`再运行：
 
 - 繁琐
-- 也模糊了业务流程
+- 模糊了业务流程
+- 简单包装多个`Action`成`CF`提交给`allOf/anyOf`的做法（业务代码往/往是这样实现的），**会呑异常**
+  - 当输入`Action`的运行抛出多个异常时，这些异常至多只能有一个能通过返回`CF`反馈给业务，其它的异常则被默默地呑掉，影响业务问题的排查
 
-`cffu`提供了直接运行多个`Action`的方法，方便直接明了地表达业务编排流程。
+`cffu`提供了直接运行多个`Action`的方法，解决上述问题：
+
+- 方便直接明了地表达与编排业务流程
+- 不呑异常，方便排查业务问题
+  - 当多个输入`Action`的运行抛出多个异常时，会打印日志报告出没有在返回`CF`中反馈给业务的异常
 
 示例代码如下：
 
 ```java
 public class MultipleActionsDemo {
+  private static final ExecutorService myBizExecutor = Executors.newCachedThreadPool();
+  private static final CffuFactory cffuFactory = CffuFactory.builder(myBizExecutor).build();
+
   static void mRunAsyncDemo() {
-    // wrap tasks to CompletableFuture first, AWKWARD! 😖
+    // wrap actions to CompletableFutures first, AWKWARD! 😖
     CompletableFuture.allOf(
         CompletableFuture.runAsync(() -> System.out.println("task1")),
         CompletableFuture.runAsync(() -> System.out.println("task2")),
         CompletableFuture.runAsync(() -> System.out.println("task3"))
     );
+    completedFuture("task").thenCompose(v ->
+        CompletableFuture.allOf(
+            CompletableFuture.runAsync(() -> System.out.println(v + "1")),
+            CompletableFuture.runAsync(() -> System.out.println(v + "2")),
+            CompletableFuture.runAsync(() -> System.out.println(v + "3"))
+        )
+    );
 
     // just run multiple actions, fresh and cool 😋
     CompletableFutureUtils.mRunAsync(
         () -> System.out.println("task1"),
         () -> System.out.println("task2"),
         () -> System.out.println("task3")
     );
+    cffuFactory.completedFuture("task").thenMAcceptAsync(
+        (String v) -> System.out.println(v + "1"),
+        v -> System.out.println(v + "2"),
+        v -> System.out.println(v + "3")
+    );
   }
 }
 ```
@@ -511,7 +532,7 @@ public class MultipleActionsDemo {
   private static final CffuFactory cffuFactory = CffuFactory.builder(myBizExecutor).build();
 
   static void thenMApplyAsyncDemo() {
-    // wrap tasks to CompletableFuture first, AWKWARD! 😖
+    // wrap actions to CompletableFutures first, AWKWARD! 😖
     completedFuture(42).thenCompose(v ->
         CompletableFutureUtils.allResultsFailFastOf(
             CompletableFuture.supplyAsync(() -> v + 1),
@@ -521,7 +542,8 @@ public class MultipleActionsDemo {
     ).thenAccept(System.out::println);
     // output: [43, 44, 45]
     cffuFactory.completedFuture(42).thenCompose(v ->
-        CompletableFutureUtils.allResultsFailFastOf(
+        CompletableFutureUtils.allSuccessResultsOf(
+            -1,
             CompletableFuture.supplyAsync(() -> v + 1),
             CompletableFuture.supplyAsync(() -> v + 2),
             CompletableFuture.supplyAsync(() -> v + 3)
@@ -537,14 +559,15 @@ public class MultipleActionsDemo {
         v -> v + 3
     ).thenAccept(System.out::println);
     // output: [43, 44, 45]
-    cffuFactory.completedFuture(42).thenMApplyFailFastAsync(
+    cffuFactory.completedFuture(42).thenMApplyAllSuccessAsync(
+        -1,
         v -> v + 1,
         v -> v + 2,
         v -> v + 3
     ).thenAccept(System.out::println);
     // output: [43, 44, 45]
 
-    CompletableFutureUtils.thenMApplyAllSuccessTupleAsync(
+    CompletableFutureUtils.thenMApplyTupleFailFastAsync(
         completedFuture(42),
         v -> "string" + v,
         v -> v + 1,

cffu-core/src/main/java/io/foldright/cffu/Cffu.java

@@ -1710,9 +1710,9 @@ public Cffu<T> exceptionallyAsync(Function<Throwable, ? extends T> fn, Executor
      * Uses {@link #defaultExecutor()} as {@code executorWhenTimeout}.
      * <p>
      * <strong>CAUTION:</strong> This method returns a new Cffu instead of this Cffu to avoid the subsequent usage of the
-     * delay thread; This behavior is DIFFERENT from the original CF method {@link CompletableFuture#orTimeout} and its
-     * backport method {@link #unsafeOrTimeout}. More info see the javadoc of {@link #unsafeOrTimeout} and the demo <a href=
-     * "https://github.com/foldright/cffu/blob/main/cffu-core/src/test/java/io/foldright/demo/CfDelayDysfunctionDemo.java"
+     * delay thread; This behavior is DIFFERENT from the original CF method {@link CompletableFuture#orTimeout CompletableFuture#orTimeout}
+     * and its backport method {@link #unsafeOrTimeout unsafeOrTimeout}. More info see the javadoc of {@link #unsafeOrTimeout unsafeOrTimeout}
+     * and the demo <a href="https://github.com/foldright/cffu/blob/main/cffu-core/src/test/java/io/foldright/demo/CfDelayDysfunctionDemo.java"
      * >DelayDysfunctionDemo</a>.
      *
      * @param timeout how long to wait before completing exceptionally with a TimeoutException, in units of {@code unit}
@@ -1734,17 +1734,17 @@ public Cffu<T> orTimeout(long timeout, TimeUnit unit) {
      * This means that the long-running subsequent non-async actions will block this executor thread, preventing it from
      * handling other timeouts and delays, effectively breaking CompletableFuture's timeout and delay functionality.
      * <p>
-     * <strong>Strongly recommend</strong> using the safe method {@link #orTimeout(long, TimeUnit)} instead of this method.
-     * Using this method is appropriate only when:
+     * <strong>Strongly recommend</strong> using the safe method {@link #orTimeout(long, TimeUnit) orTimeout}
+     * instead of this method. Using this method is appropriate only when:
      * <ul>
      * <li>the returned Cffu is only read explicitly(e.g. by get/join/resultNow methods), and/or
      * <li>all subsequent actions of dependent Cffus/CompletableFutures are guaranteed to execute asynchronously
      *    (i.e., the dependent Cffus/CompletableFutures are created using async methods).
      * </ul> In these cases, using this unsafe method avoids an unnecessary thread switch when timeout occurs; However,
      * these conditions are difficult to guarantee in practice especially when the returned Cffu is used by others' codes.
      * <p>
-     * Note: Before Java 21(Java 20-), {@link CompletableFuture#orTimeout} leaks if the future completes exceptionally,
-     * more info see <a href="https://bugs.openjdk.org/browse/JDK-8303742">issue JDK-8303742</a>,
+     * Note: Before Java 21(Java 20-), {@link CompletableFuture#orTimeout CompletableFuture#orTimeout} leaks if the future
+     * completes exceptionally, more info see <a href="https://bugs.openjdk.org/browse/JDK-8303742">issue JDK-8303742</a>,
      * <a href="https://github.com/openjdk/jdk/pull/13059">PR review openjdk/jdk/13059</a>
      * and <a href="https://github.com/openjdk/jdk/commit/ded6a8131970ac2f7ae59716769e6f6bae3b809a">JDK bugfix commit</a>.
      * The cffu backport logic(for Java 20-) has merged this JDK bugfix.
@@ -1770,9 +1770,9 @@ public Cffu<T> unsafeOrTimeout(long timeout, TimeUnit unit) {
      * <p>
      * <strong>CAUTION:</strong> This method returns a new Cffu instead of this Cffu
      * to avoid the subsequent usage of the delay thread; This behavior is DIFFERENT from the original CF method
-     * {@link CompletableFuture#completeOnTimeout} and its backport method {@link #unsafeCompleteOnTimeout}.
-     * More info see the javadoc of {@link #unsafeCompleteOnTimeout} and the demo <a href=
-     * "https://github.com/foldright/cffu/blob/main/cffu-core/src/test/java/io/foldright/demo/CfDelayDysfunctionDemo.java"
+     * {@link CompletableFuture#completeOnTimeout CompletableFuture#completeOnTimeout} and its backport method {@link
+     * #unsafeCompleteOnTimeout unsafeCompleteOnTimeout}. More info see the javadoc of {@link #unsafeCompleteOnTimeout} and the demo
+     * <a href="https://github.com/foldright/cffu/blob/main/cffu-core/src/test/java/io/foldright/demo/CfDelayDysfunctionDemo.java"
      * >DelayDysfunctionDemo</a>.
      *
      * @param value   the value to use upon timeout
@@ -1794,8 +1794,8 @@ public Cffu<T> completeOnTimeout(@Nullable T value, long timeout, TimeUnit unit)
      * This means that the long-running subsequent non-async actions will block this executor thread, preventing it from
      * handling other timeouts and delays, effectively breaking CompletableFuture's timeout and delay functionality.
      * <p>
-     * <strong>Strongly recommend</strong> using the safe method {@link #completeOnTimeout(Object, long, TimeUnit)}
-     * instead of this method. Using this method is appropriate only when:
+     * <strong>Strongly recommend</strong> using the safe method {@link #completeOnTimeout(Object, long, TimeUnit)
+     * completeOnTimeout} instead of this method. Using this method is appropriate only when:
      * <ul>
      * <li>the returned Cffu is only read explicitly(e.g. by get/join/resultNow methods), and/or
      * <li>all subsequent actions of dependent Cffus/CompletableFutures are guaranteed to execute asynchronously

cffu-core/src/main/java/io/foldright/cffu/CffuFactory.java

@@ -1228,8 +1228,8 @@ public <T> CompletionStage<T> failedStage(Throwable ex) {
     ////////////////////////////////////////////////////////////////////////////////
 
     /**
-     * Returns a Cffu maintaining the same completion properties as the given stage and this {@code CffuFactory} config.
-     * If the given stage is already a Cffu and have the this {@code CffuFactory}, this method may return the given stage.
+     * Returns a Cffu that maintains the same completion properties as the given stage, configured with this {@code CffuFactory}.
+     * If the given stage is already a Cffu and uses this {@code CffuFactory}, this method may return the given stage.
      *
      * @throws NullPointerException if the given stage is null
      * @see CompletionStage#toCompletableFuture()