Spring6｜Spring Boot3有哪些HTTP客户端可以选择

个人博客：无奈何杨（wnhyang）

个人语雀：wnhyang

共享语雀：在线知识共享

Github：wnhyang - Overview

---

参考

REST Clients :: Spring Framework

【微服务|SpringBoot 3.0】 新特性——内置声明式HTTP客户端_springboot3.0 内置http服务-CSDN博客

七大主流的HttpClient程序比较

1、Java HttpURLConnection

JDK自带的标准HTTP客户端API，尽管功能相对基础，但因为内置于JDK中，无需额外依赖，所以在许多简单场景下仍然被广泛使用。

2、Java11 HttpClient

自Java 11起，JDK新增了一个更现代化且功能更完善的HTTP客户端API，旨在替代原有的HttpURLConnection，支持HTTP/2和异步操作。

3、Apache HttpClient

由Apache软件基金会提供的成熟的HTTP客户端库，支持同步和异步操作，具备高度可配置性，提供了强大的连接管理和认证支持。

SpringBoot下配合RestTemplate组件使用示例如下。

@Configuration
public class HttpClientConfig {

    @Bean
    public HttpClient httpClient() {
        PoolingHttpClientConnectionManager connectionManager = new PoolingHttpClientConnectionManager();
        // 设置最大连接数
        connectionManager.setMaxTotal(200);
        // 每个路由的基础连接数
        connectionManager.setDefaultMaxPerRoute(20);

        // 其他可能的配置选项...
        
        CloseableHttpClient httpClient = HttpClients.custom()
                .setConnectionManager(connectionManager)
                // 可以设置重试策略、超时等其他参数
                .build();

        return httpClient;
    }

    @Bean
    public HttpComponentsClientHttpRequestFactory clientHttpRequestFactory(HttpClient httpClient) {
        HttpComponentsClientHttpRequestFactory factory = new HttpComponentsClientHttpRequestFactory();
        factory.setHttpClient(httpClient);
        return factory;
    }

    @Bean
    public RestTemplate restTemplate(HttpComponentsClientHttpRequestFactory factory) {
        return new RestTemplate(factory);
    }
}

4、OkHttp

由Square公司开发的高性能HTTP客户端库，尤其适合移动和服务器端环境，内置连接池和失败重试机制，支持HTTP/2和SPDY协议，同时也支持同步和异步API。

简单示例如。

@Configuration
public class OkHttpConfig {
   @Bean
   public OkHttpClient okHttpClient() {
       return new OkHttpClient.Builder()
               .connectTimeout(10, TimeUnit.SECONDS)
               .readTimeout(10, TimeUnit.SECONDS)
               .build();
   }
}

分界

上面的都属于底层Http类库，基于以上还有很多组件可以使用。既然是组件，就是为了简化调用的，所以使用起来参看Java Doc就可以了

5、Retrofit

虽然Retrofit最初是为Android设计，但同样可以在Spring Boot环境中使用。Retrofit基于OkHttp之上提供了更为简洁优雅的API设计，通过注解的方式将接口与HTTP请求映射，大大简化了RESTful API的调用过程。结合Gson或其他JSON转换器，它可以轻松地处理JSON格式的数据交换。在Spring Boot项目中，尽管Retrofit主要面向REST服务消费，但它也可以与Spring框架紧密结合，通过自定义适配器来更好地融入Spring生态环境。

6、SpringBoot RestTemplate

Spring Boot 自带的 RestTemplate 是一个轻量级且全面的HTTP客户端，内置在Spring框架中。它简化了与RESTful服务之间的交互，提供了丰富的模板方法来执行GET、POST等各种HTTP操作，并能够自动转换HTTP响应为Java对象。然而，RestTemplate 在并发场景下性能并不突出，且不具备连接池和流式API支持，对于复杂的HTTP调用可能需要更多手动配置。

7、Spring5 WebClient

自Spring 5引入WebFlux之后，WebClient 成为了非阻塞式的HTTP客户端首选。其基于Reactor项目，完全支持异步和响应式编程模型，允许构建高效、可扩展的服务。WebClient 提供了强大的API来处理各种HTTP请求和响应，包括流式处理、多路复用以及灵活的背压控制，尤其适合高并发和低延迟的应用场景。

8、Spring Cloud Feign

Spring Cloud Netflix Feign是一个声明式的伪客户端，它使编写Web服务客户端变得更简单。

它允许你定义一个接口并使用注解来指定HTTP方法、URL模板以及参数绑定，然后通过动态代理生成实现类来进行远程调用。

适合微服务架构下服务间通信，具有良好的可读性和一致性。

9、Spring6.1 RestClient

官方描述：RestClient是一个同步HTTP客户端，它提供了一个现代、流畅的API。它提供了对HTTP库的抽象，允许从Java对象到HTTP请求的方便转换，以及从HTTP响应创建对象。

10、Spring6 HTTP interface

官方描述：Spring Framework允许您使用@HttpExchange方法将HTTP服务定义为Java接口。您可以将这样的接口传递给HttpServiceProxyFactory，以创建一个代理，该代理通过HTTP客户端（如RestClient或WebClient）执行请求。您还可以从@Controller实现用于服务器请求处理的接口。

简单的来讲，可以类比为OpenFeign，使用方法是几乎一样的。

小结

综上，关于底层的Http类库，比较推荐Apache HttpClient和OkHttp。关于上层组件，如果追求现代非阻塞IO及响应式编程，WebClient是首选；如果偏好简单的同步操作和Spring框架的无缝集成，RestTemplate是基础选项，Spring6可以使用RestClient；而对于更高级别的API调用抽象和微服务架构，Feign或Retrofit则是值得考虑的候选者，当然未来HTTP interface有可能更加通用。

写在最后

拙作艰辛，字句心血，望诸君垂青，多予支持，不胜感激。

---

个人博客：无奈何杨（wnhyang）

个人语雀：wnhyang

共享语雀：在线知识共享

Github：wnhyang - Overview