CompletableFutureFu 使用指南

🦝 CompletableFutureFu 使用指南

1. 项目介绍

CompletableFuture Fu, 简称 Cffu 🦝，是为Java开发者精心设计的一个轻量级库，旨在增强 CompletableFuture 的使用体验，减少误用风险，使其在实际业务场景中更加高效、便捷和安全。它提供了多种便利特性和策略，如自定义线程池、灵活的并发控制策略（包括全失败快退、任一成功、全部成功等）、超时处理以及类型丰富的组合操作方法。Cffu兼容Java 8及以上版本，并且通过其精巧的API设计，让异步编程变得更加得心应手。

2. 项目快速启动

要快速开始使用Cffu，首先添加依赖到你的项目中。以下是Maven和Gradle的配置示例：

Maven

<dependency>
    <groupId>io.foldright</groupId>
    <artifactId>cffu-ttl-executor-wrapper</artifactId>
    <version>1.0.0-Alpha19</version>
    <scope>runtime</scope>
</dependency>

Gradle (Kotlin DSL)

runtimeOnly("io.foldright:cffu-ttl-executor-wrapper:1.0.0-Alpha19")

或者使用Gradle (Groovy DSL):

runtimeOnly 'io.foldright:cffu-ttl-executor-wrapper:1.0.0-Alpha19'

接下来，简要示范如何使用Cffu进行基本的异步任务执行：

import io.foldright.cffu.Cffu;

public class QuickStart {
    public static void main(String[] args) {
        Cffu<String> future = Cffu.runAsync(() -> {
            Thread.sleep(1000); // 模拟耗时操作
            return "Hello, CompletableFuture Fu!";
        });

        future.join(); // 等待结果
        System.out.println(future.getNow(null)); // 输出结果
    }
}

3. 应用案例和最佳实践

使用Cffu，你可以以更加优雅的方式处理复杂的异步逻辑。比如实现一个并发策略，确保所有任务尽可能快速失败 (AllFastFail)：

List<Cffu<String>> tasks = ...; // 初始化一系列异步任务
Cffu<Void> combined = Cffu.allResultsFastFailOf(tasks);
combined.thenAccept(__ -> System.out.println("所有任务已完成或第一个失败已触发停止"));

最佳实践中，推荐预先配置业务线程池，以优化资源利用和控制并发度：

ExecutorService myPool = Executors.newFixedThreadPool(10);
Cffu.withCustomPool(myPool).runAsync(() -> {/*你的任务*/});

4. 典型生态项目

Cffu因其专注提升CompletableFuture的易用性而存在，它本身即是Java生态系统中针对现代并发编程的一个补充。虽然直接相关联的“生态项目”指涉较少，但其与任何广泛采用CompletableFuture的框架或库都能良好协作，例如Spring Framework中的异步方法处理。通过结合Spring的异步支持，Cffu可以进一步简化Web应用中的异步请求处理。

在选择Cffu作为辅助工具时，它与Java标准库的无缝集成，使得开发者能够在微服务架构、反应式编程、或是传统的基于Future模式的应用中，享受到更加流畅和可靠的异步编程体验。

---

以上就是Cffu的基本使用指南，深入探索它的更多功能，将有助于提升你的异步编程技能，使代码更为健壮且易于维护。