# CompletableFuture Demo

一个用于学习 JDK `CompletableFuture` API 的 Java 17 / Maven 教学项目，包含配套的中文教程文档与可直接运行的代码示例（`Cf01`..`Cf10`）。

## 技术栈

- JDK 17
- Maven（无第三方依赖，纯 JDK API）

## 目录结构

```
completableFeature-demo/
├── src/main/java/space/anyi/       # 示例代码，每个 API 主题一个文件，均有独立 main()
├── completablefuture-tutorial.md   # 中文教程文档（循序渐进，配合示例代码）
├── completablefuture-blog.md       # 面向资深 Java 程序员的速查/博客文档
├── template.md                     # 写作风格与结构参考文档
└── todo.md                         # 待办任务清单
```

## 示例代码一览

| 文件 | 主题 |
|------|------|
| `Cf01_CreateStage` | 创建异步任务：`runAsync` / `supplyAsync` / `completedFuture` / `getNow` |
| `Cf02_ThenSeries` | 串行处理：`thenApply` / `thenAccept` / `thenRun` |
| `Cf03_ThenCombine` | 组合两个任务：`thenCombine` / `thenAcceptBoth` / `runAfterBoth` |
| `Cf04_ThenEither` | 二选一：`applyToEither` / `acceptEither` / `runAfterEither` |
| `Cf05_ThenCompose` | 展平组合：`thenCompose` |
| `Cf06_AllOfAnyOf` | 批量聚合：`allOf` / `anyOf` |
| `Cf07_ExceptionHandling` | 异常处理：`exceptionally` / `whenComplete` / `handle` |
| `Cf08_ManualComplete` | 手动完成与状态查询：`complete` / `completeExceptionally` / `obtrudeValue` / `isDone` / `cancel` |
| `Cf09_CustomExecutor` | 线程池与 Async 变体 |
| `Cf10_TimeoutAndException` | 超时与异常链：`orTimeout` / `completeOnTimeout` / `exceptionallyCompose` |

详细讲解见 `completablefuture-tutorial.md`。

## 构建与运行

```bash
mvn compile                                   # 编译
mvn exec:java -Dexec.mainClass=space.anyi.Cf01_CreateStage   # 运行某个示例
```

## 注意事项

- `exec:java` 需要显式指定 `-Dexec.mainClass`。
- Windows 下 PowerShell 会把未加引号的 `-Dexec.mainClass=...` 拆分，需要加引号：`'-Dexec.mainClass=space.anyi.Cf01_CreateStage'`。
- 控制台默认 GBK 编码，中文输出在终端可能乱码，程序本身是正确的。
- `Cf10`（使用 `orTimeout` / `completeOnTimeout`）在 `exec:java` 下会因 JDK 延迟调度线程残留而报线程组清理错误，属误报。请改用普通方式运行：

```bash
java -cp target/classes space.anyi.Cf10_TimeoutAndException
```