正文

Forest v1.5.25 发布，声明式 HTTP 客户端框架

admin
admin V管理员 /0 评论 /699 阅读
0719
此篇文章发布距今已超过843天，您需要注意文章的内容或图片是否可用！
KodeRover 联合 OSCHINA 推出云原生 DevOps 现状调研问卷，欢迎填写>>>>>

Forest 介绍

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

Forest 如何使用

Forest 不需要您编写具体的 HTTP 调用过程，只需要您定义一个接口，然后通过 Forest 注解将 HTTP 请求的信息添加到接口的方法上即可。请求发送方通过调用您定义的接口便能自动发送请求和接受请求的响应

Forest 的工作原理

Forest 会将您定义好的接口通过动态代理的方式生成一个具体的实现类，然后组织、验证 HTTP 请求信息，绑定动态数据，转换数据形式，SSL 验证签名，调用后端 HTTP API (httpclient 等 API) 执行实际请求，等待响应，失败重试，转换响应数据到 Java 类型等脏活累活都由这动态代理的实现类给包了。 请求发送方调用这个接口时，实际上就是在调用这个干脏活累活的实现类

获得奖项

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

https://www.oschina.net/project/top_cn_2021

文档和示例

  • 项目官网
  • JavaDoc
  • Demo 工程

简单的例子

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

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

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

本次更新

修复的问题

  • fix: 匹配验证secure cookie
  • fix: cookie携带请求不成功 (#I5F8IY:cookie携带请求不成功)
  • fix: OKHTTP 连接泄漏问题 (#I5E613:OKHTTP 连接泄漏问题)
  • fix: forest 支持springboot 1.5.14.realese 启动失败 (#I5FDBG:forest 支持springboot 1.5.14.realese 启动失败)
  • fix: 传的参数带有+号，但是服务接收时，获取的参数值中+号全部变成空格了 (#I5EG9L:传的参数带有+号，但是服务接收时，获取的参数值中+号全部变成空格了)

其它改动

  • add: OkHttp3Cookie
  • add: HttpclientCookie
  • update: 更新jackson版本到2.13.3
  • update: 更新jackson-databind版本到2.13.3
  • update: 更新jackson-annotations版本到2.13.3
  • update: 更新gson版本到2.8.9
  • update: 更新fastjson版本到1.2.83

 

宙飒天下