【极简版】HC fluent HTTP API使用小知识

苏南(src)

已于 2023-11-29 09:56:37 修改

阅读量393

点赞数 9

文章标签： http 网络协议

于 2023-11-27 11:57:41 首次发布

本文链接：https://blog.csdn.net/src1025/article/details/134641583

版权

HTTP + FLUENT API

背景： HTTP客户端框架有很多，比较著名的是Apache Httpclient、okhttp、Retrofit等。因为接手项目中原来用的框架就是fluent api，使用要求也不高，所以一直没有更改。在此记录使用该客户端的一些小问题（弄懂了就变成小知识）。

博客内容精选：
1、Servlet请求体重复读&修改新姿势
 2、根据请求获取后端接口详情
 3、封装Springboot项目的starter-sdk新方式
 4、Springboot全局处理完整版
 5、itextpdf读取文本时上下行位置错乱
 6、JAVA读取PDF表格内容
 7、JAVA读取PDF出现内容错乱

常见使用方式如下：

String content = Request.Get(url)
       .connectTimeout(connect-timeout)
       .socketTimeout(read-timeout)
       .addHeader(custom-header)
       .execute()
       .returnContent()
       .toString();

在目前较为普遍的restful api返回的基本都是json串，通过请求获取的响应字符串，即可解析出对应所需要的数据，正常情况下基本没有问题，但在接口请求异常时且封装HTTP状态码非200时，直接抛出IO异常。这个时候有个尴尬的事情出现了，我们通常会在返回json中说明异常详情及原因，此时只能通过异常看见状态码了，对接调试的时候就有点麻烦。造成这个现象的原因是返回偷懒使用了returnContent方法，里面默认使用ContentResponseHandler处理返回内容，具体代码如下：
在这里插入图片描述
ContentResponseHandler继承了父抽象类请求处理的方法，在该方法中所有响应状态大于等于300的统一抛出异常，所有我们的错误说明响应体无法获取到了。解决办法也很简单：

HttpResponse httpResponse = Request.Get(url)
       .connectTimeout(connect-timeout)
       .socketTimeout(read-timeout)
       .addHeader(custom-header)
       .execute()
       .returnResponse();
UserInfo entity = GSON_INSTANCE.fromJson(EntityUtils.toString(httpResponse.getEntity(), "UTF-8"), UserInfo.class);
if (200 == entity.getCode() && entity.getData() != null) {
    return entity.getData();
}
throw new AuthException(entity.getMsg());

注意：在响应实体封装时，指定了UTF-8编码，现在Springboot默认使用的header没有包含字符集编码的header，浏览器默认会使用UTF-8，但这些框架可能还默认使用ISO_8859_1字符集，就会造成乱码。如果服务端是自己的，则可以设置spring.http.encoding.enabled=true来强制使用UTF-8。