【说站】Forest v1.5.3 正式版本发布

2022-11-24 17:23:43 浏览数 (2)

Forest v1.5.3 正式版本发布

v1.5.3 本版发布了,本次版本更新新增了较多功能,其中有许多重大更新。

1. 新增Forest快捷接口

以前版本使用 Forest,必须先定义一个 interface 接口类,这种形式可以满足大多数情况的场景。 但若想快速访问一个url可能显得不合时宜。 所以本次更新新增了快捷接口,不用再从定义接口开始了。

它大概长这个样子:

代码语言:javascript复制
// Get请求
// 并以 String 类型接受数据
String str = Forest.get("/").executeAsString();
 
// Post请求
// 并以自定义的 MyResult 类型接受
MyResult myResult = Forest
   .post("/")
   .execute(MyResult.class);
 
// 通过 TypeRefernce 引用类传递泛型参数
// 就可以将响应数据以带复杂泛型参数的类型接受了
Result<List<User>> userList = Forest
   .post("/")
   .execute(new TypeReferenceList<Result<List<User>>>() {});
 
 
// 定义各种参数
// 并以 Map 类型接受
Map<String, Object> map = Forest.post("/")
      .backend("okhttp3")        // 设置后端为 okhttp3
      .contentTypeJson()         // 设置 Content-Type 头为 application/json
      .host("127.0.0.1")         // 设置地址的host为 127.0.0.1
      .port(8080)                // 设置地址的端口为 8080
      .addBody("a", 1)           // 添加 Body 项(键值对): a, 1
      .addBody("b", 2)           // 添加 Body 项(键值对:  b, 2
      .maxRetryCount(3)          // 设置请求重试次数为 3
      // 设置 onSuccess 回调函数
      .onSuccess((data, req, res) -> { log.info("success!"); })
      // 设置 onError 回调函数
      .onError((ex, req, res) -> { log.info("error!"); })
      // 设置请求成功判断条件回调函数
      .successWhen((req, res) -> res.noException() && res.statusOk())
      // 执行并返回Map数据类型对象
      .executeAsMap();

 2. 请求成功条件/重试条件

@Success 注解

先要定义 SuccessWhen 接口的实现类

代码语言:javascript复制
public class TestSuccessWhen implements SuccessWhen {
 
    /**
     * 请求成功条件
     * @param req Forest请求对象
     * @param res Forest响应对象
     * @return 是否成功
     */
    @Override
    public boolean successWhen(ForestRequest req, ForestResponse res) {
        // 没有异常 并且 状态码在正常范围 并且 状态码不等于203
        // 当然在这里也可以写其它条件,比如 通过 res.getData() 或 res.getConent() 获取业务数据
        // 再更具业务数据判断是否成功
        return res.noException() && res.statusOk() && res.statusCode() != 203;
    }
}

以上就是Forest v1.5.3 正式版本发布的介绍,希望对大家有所帮助。更多精彩内容分享:头条

0 人点赞