正文

Forest v1.5.30 发布，适配 SpringBoot3 和 Solon，新增延迟参数

admin
admin V管理员 /0 评论 /281 阅读
0323
此篇文章发布距今已超过597天，您需要注意文章的内容或图片是否可用！

Forest介绍

Forest 是一个开源的 Java HTTP 客户端框架，它能够将 HTTP 的所有请求信息（包括 URL、Header 以及 Body 等信息）绑定到您自定义的 Interface 方法上，能够通过调用本地接口方法的方式发送 HTTP 请求

获得奖项

  • 2021 年度 OSC 中国开源项目评选「最受欢迎项目」

  • 2022 年度 OSC 中国开源项目评选「最火热中国开源项目社区」

简单的栗子

  • 声明式接口

创建一个 interface，并用@Get注解修饰接口方法。

 public interface MyClient {     @Get("http://localhost:8080/hello")     String hello(); }

通过@Get注解，将上面的 MyClient 接口中的simpleRequest()方法绑定了一个 HTTP 请求， 其 URL 为http://localhost:8080/hello，并默认使用 GET 方式，且将请求响应的数据以 String 的方式返回给调用者

  • 编程式接口

 Forest.get("http://localhost:8080/hello").execute();

编程式接口则更为简单直接

新增特性

  • 支持和适配了 SpringBoot3

  • 支持和适配了 Solon 框架

  • 支持延迟参数特性

延迟参数 (Lambda参数)

有很多情况，Header、Query、Body的参数值不能马上得出，而是在请求发送前的那一刻（所有请求参数都到位时）才能得出，典型的例子就是加签验证的场景（在Header中添加一个参数token，而token的值是对整个body做加密的结果）

  • 请求头的延迟参数

 Forest.post("/test")         .addHeader("Content-Type", "application/json; charset=UTF-8")          // 普通请求头         .addHeader("Authorization", req -> Base64.encode(req.body().encode())) // 延迟请求头         .addBody("id", "1972664191")      // 请求体参数 id         .addBody("name", "XieYu20011008") // 请求体参数 name         .execute();

  • 请求体的延迟参数

 Forest.post("/test")         .addHeader("Content-Type", "application/json; charset=UTF-8")  // 请求头         .addHeader("_id", "20011008")                                  // 请求头         .addBody("id", "1972664191")                                   // 请求体参数 id         .addBody("name", req -> "Foo" + req.headerValue("_id"))        // 延迟请求体参数 name         .addBody("token", req -> Base64.encode(req.body().encode()))   // 延迟请求体参数 token         .execute();                                                    // 执行请求

官网和仓库地址

官网地址:

http://forest.dtflyx.com

Gitee 仓库地址:

https://gitee.com/dromara/forest

Github 仓库地址:

https://github.com/dromara/forest

本次更新内容

  • feat: 适配 springboot3

  • feat: 适配 solon

  • feat: 延迟参数 (Lambda参数)，支持 Query, Header，Body 三种参数的延迟求值

  • feat: 可自定义异步请求池拒绝策略

  • feat: 请求体序列化接口，ForestRequest.body().encode() 和 ForestRequest.body().encodeToString()

  • fix: ForestProxy添加header没有效果

  • fix: onBodyEncode 生命周期顺序问题

  • fix: 不同 ForestConfiguration 对象共用同一个异步线程池的问题

  • fix: 无法解析 localhost:8080 这类省略 http:// 的 url

  • reflector: 将xml解析模块拆分成了 forest-jaxb 和 forest-jakarta-xml 两个子模块，需要的情况要分别自行引入

  • reflector: request body encoder

  • refactor: Forest Body clone

  • refactor: 构建 Query String 部分

  • add: HTTPRoxy 注解的 headers 属性

  • add: forest 示例工程

宙飒zhousa.om