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 正式版本发布的介绍,希望对大家有所帮助。更多精彩内容分享:头条