异步API增强

异步API增强

## 支持 `Async/Await` 风格

自 Ajax 流行开始，回调函数的异步处理方式就已经深入人心，这种方法虽好，但也有不少问题

比如回调地狱：很容易写出在A请求的回调函数中调用B请求，然后在B请求的回调函数中调用C请求，这样的套娃代码

另一个问题，就是执行回调函数所在的线程和调用接口的线程并非同一个线程，这就会引入并发和锁的问题，处理的时候需要谨慎对待

为了解决这些问题，需引入 Async/Await 方式

```java
String result = Forest.get("/foo") // 创建 GET 请求
        .async()                   // 设置为异步
        .executeAsFuture()         // 发送请求，并返回 ForestFuture 对象
        .await()                   // 阻塞线程并等待请求响应，成功响应后会返回 ForestResponse 对象
        .get(String.class);        // 调用 ForestResponse 的 get 方法进行转换数据并返回结果
```

同时发送和接受多个异步请求

```java
ForestFuture f1 = Forest.get("/foo") // 创建第一个 GET 请求
        .async()                     // 设置为异步
        .addQuery("id", 0)           // 设置 Query 参数
        .executeAsFuture();          // 发送请求并返回 ForestFuture 对象

ForestFuture f2 = Forest.get("/bar") // 创建第二个 GET 请求
        .async()                     // 设置为异步
        .addQuery("id", 1)           // 设置 Query 参数
        .executeAsFuture();          // 发送请求并返回 ForestFuture 对象

// 在这里并不阻塞线程，可以做些其它事情
doSomething();

// Forest.await 方法会阻塞线程并同时等待多个请求
// 只有当所有请求都完成时，才会继续往下执行
Forest.await(f1, f2).forEach(res -> {          // 遍历每个 ForestResponse 对象
        String result = res.get(String.class); // 从 ForestResponse 中取出数据
});

```

批量发送和等待多个异步请求

```java
// new 一个 ForestFuture 对象列表
List<ForestFuture> futures = new LinkedList<>();
for (int i = 0; i < 100; i++) {     // 循环100次
    futures.add(Forest.get("/data") // 创建请求，并添加到 futures 列表中
        .async()                    // 设置为异步
        .addQuery("id", i)          // 设置 Query 参数
        .executeAsFuture());        // 发送请求，返回 ForestFuture 对象
}

Forest.await(futures).forEach(res -> {     // 等待这100个请求，然后进行遍历
    String result = res.get(String.class); // 从 ForestResponse 中取出数据
});
```

dromara/forest

内容风险标识

评论 (3)

dromara/forest .gitee-modal { width: 500px !important; }

内容风险标识