1.HttpClient5升级笔记--API篇

HttpClient5升级笔记--API篇

       Apache HttpClient 5，源码作为Apache HttpComponents 项目中的源码关键组件，旨在提供发送 HTTP 请求和处理 HTTP 响应的源码手段。然而，源码从版本4升级到5，源码对于许多开发者来说，源码公共信息平台 源码这并非一个轻松的源码过程。尽管新版带来了诸多潜在优势，源码但在实际应用中，源码这些好处往往显得相对有限，源码与升级带来的源码成本相比，性价比并不显著。源码程序怎么查看源码唯一吸引人的源码，可能是源码对HTTP/2的支持，但本地尚未开发相关接口，源码实际测试还需等待。

       对于FunTester项目的升级，依赖版本保持不变，关键在于排除项目中其他库依赖的HttpClient 4.x版本，以避免潜在的干扰。接下来，我们逐一探讨API的变化点。

       首先，源码时代的作用包名的变化是显而易见的，从过去的`org.apache.http`变更为`org.apache.hc.client5`，这需要开发者进行手动的适配调整。在重试机制方面，`HttpRequestRetryHandler`被替换为`HttpRequestRetryStrategy`，尽管实现方法有所调整，但整体逻辑相似。`HttpRequestRetryStrategy`引入了额外的方法，用于对响应信息进行判断和重试间隔的获取，这为开发者提供了更多的灵活性。

       连接配置方面，西藏离青海源码旧版代码中的一系列配置已被取消，但总体影响不大，特别是在性能测试场景下。连接池管理器的变化较为显著，旧版的API被取消，推荐使用`builder`进行创建。默认的HTTP连接工厂类已注册至连接池管理器，减少了重复配置的需要。对于异步连接池管理器，虽然在代码结构上大体相似，但引入了新的箱体加股价源码`TlsStrategy`类，用于控制TLS的配置。

       请求配置中，大量API被取消，主要原因是减少重复配置，提升代码可读性。一个值得注意的变化是`cookieSpec`配置项的保留与API的取消，这需要开发者用字符串代替，以适应新的API体系。在性能测试中，通常不需要CookieStore管理cookie，因此这部分被忽略。

       创建`HttpClient`的方式也有所改变，引入了新的API`org.apache.hc.client5.http.impl.classic.HttpClientBuilder#disableCookieManagement`，用于取消CookieStore的配置。在拦截器部分，方法参数增加了一项，而资源回收方面，连接池管理器提供了两个资源回收方法，通常在异步场景中使用。

       在异步客户端方面，虽然启动方法保持不变，但在状态属性的判断逻辑上有所区别。代理配置的调整要求开发者在`RequestConfig`中设置，而非直接在`HttpClient`中操作。实体接口方面，请求和响应对象的名称发生了变化，取消了`boolean expectContinue()`方法，转向使用`org.apache.hc.core5.http.HttpEntityContainer`来管理实体。

       全员携带实体的改变，使得GET和DELETE请求默认携带实体，这在新版中成为标准操作，带来了便利。设置实体的API也从字符串编码格式调整为使用`java.nio.charset.Charset`，这是一次明显的进步。

       获取响应行的API`getStatusLine`被取消，取而代之的是使用`org.apache.hc.client5.http.impl.classic.CloseableHttpResponse#getCode`来获取状态码，这在一定程度上简化了获取流程，但与HTTP请求的构成保持了一致性。获取URI的方法也进行了调整，从`getURI`到`getUri`，以及`getRequestUri`，大小写的变化可能是为了适应代码自动补全工具。

       在异步请求处理中，HttpClient 5引入了新的请求和响应对象`SimpleHttpRequest`和`SimpleHttpResponse`，与之前的同步请求对象保持了一致的拷贝方法`copy()`，但被标记为过时。从源码中可以看出，这些类提供了创建GET和POST请求的便捷方式。对于异步响应中的body获取，`SimpleHttpResponse#getBodyText`提供了一种方法，但在同步方法中并不适用。

       总结起来，HttpClient 5的升级过程充满了挑战，但通过详细的代码调整和适应，可以实现平稳过渡。然而，如果没有特定的升级需求，建议评估是否真的需要进行这一升级。