HTTP客户端工具该选哪个？进来看

这是我参与11月更文挑战的第26天，活动详情查看：2021最后一次更文挑战

前言

HTTP（超文本传输协议）是一种应用层协议，用于客户端和服务端进行通信，按照标准格式如JSON、XML等进行网络数据的传输，通常也作为应用程序之间以RESTAPI形式进行通信的常用协议。

在Java应用中需要调用其他应用提供的HTTP服务API时，通常需要使用一些HTTP客户端组件。

而可选择的HTTP客户端有很多，本期内容主要介绍在Java应用程序中可以使用的HTTP客户端工具。

概述

本文主要介绍的HTTP客户端包括：

• Java 11+版本中提供的HttpClient
• Apache HttpComponents项目中的HttpClient
• OkHttpClient
• Spring Boot中的WebClient

为了更好的进行对比，我们在示例中将分别使用不同的客户端完成异步GET请求和同步POST请求。

GET请求

对于Get请求，我们通过请求以下接口查询北京未来3天的天气预报。

请求地址为http://api.weatherdt.com/common/?area=101010100&type=forecast&key=645cc4f76d011bbd8717b1607d6cb9d7。

POST请求

对于POST请求，我们通过访问https://getman.cn/echoAPI测试接口，该接口接收一个JSON参数。

对于所有的HTTP客户端工具，发送一个请求的过程基本一致，包含如下步骤：

• 创建一个HTTP Client实例
• 创建用于发送请求的Request对象
• 设置使用同步或异步方式并调用
• 处理HTTP响应数据

接下来使用不同的HTTP客户端来完成功能。

JDK原生HttpClient

原生HttpClient是在Java 9中作为孵化模块引入的，然后在Java11中作为JEP 321的一部分正式可用，HTTPClient取代了JDK更早期的HttpUrlConnection类。

HttpClient支持以下功能：

• 支持HTTP1.1、HTTP2.0协议
• 支持同步和异步编程模型
• 支持请求和响应的流式处理
• 支持Cookie

异步GET请求

使用HttpClient进行异步GET请求的代码如下所示：

在上面代码中使用构建器模式创建了HttpClient和HttpRequest的实例，然后对REST API进行异步调用。

在创建请求时，我们通过调用get()方法将HTTP方法设置为GET，并在设置10秒的超时时间。

同步POST请求

对于POST请求，可以在构建器上调用POST(BodyPublisher Body)方法，可以使用HttpRequest.BodyPublishers.ofString(String requestBody)将JSON字符串转换为BodyPublisher作为需要发送的数据参数。

在以上代码中，通过prepareRequest()方法模拟出作为请求数据的JSON字符串，同样使用构建器模式，通过POST()将请求方式设置为POST，对于返回结果，可以通过HttpResponse.BodyHandlers.ofString()转换为字符串。

如果你的项目中使用的JDK版本11+，则原生的HTTP Client可以作为首选。

Apache HttpComponents

HttpComponents是Apache软件基金会的一个开源项目，该项目中包含了可用于HTTP协议的Java工具集。

该项目下的组件分为以下两部分：

HttpCore：一组低级HTTP传输组件，可用于构建自定义客户端和服务器端HTTP服务；

HttpClient：基于HttpCore的符合HTTP协议的HTTP代理实现。

同时，它还为提供了客户端身份验证、HTTP状态管理和HTTP连接管理等组件。

首先，使用该组件需要添加Maven依赖：

<dependency>
    <groupId>org.apache.httpcomponents.client5</groupId>
    <artifactId>httpclient5</artifactId>
    <version>5.1.1</version>
</dependency>
复制代码

异步GET请求

使用Apache HttpClient进行异步REST API调用的常见方法如下所示：

主要步骤如下：

• 首先创建CloseableHttpAsyncClient作为HTTP客户端；
• 然后调用start()方法启动客户端；
• 使用SimpleHttpRequest创建请求；
• 并通过调用Execute()方法发送请求，并设置FutureCallback对象来异步处理不同响应结果。

同步POST请求

使用Apache HttpClient发送同步POST请求代码如下：

发送同步POST请求的步骤如下：

• 首先通过prepareRequest()方法创建出一个JSON字符串，作为请求数据；
• 创建HttpPost对象作为POST请求实例，并将请求数据和请求头数据设置到HttpPost对象中；
• 通过HttpClients.createDefault()创建HTTP客户端实例；
• 调用execute()方法发送请求；
• 从返回值CloseableHttpResponse中获得响应数据。

当使用的JDK版本为11以下的版本，或者需要将功能作为插件提供给别的系统使用时，Apache HttpClient是一个比较好的选择。

OkHttpClient

OkHttpClient也是一个开源库，由美国的Square公司提供。

同样需要添加对应的Maven依赖：

<dependency>
    <groupId>com.squareup.okhttp3</groupId>
    <artifactId>okhttp</artifactId>
    <version>4.9.2</version>
</dependency>
复制代码

异步GET请求

使用OkHttpClient发送异步GET请求的代码如下：

使用OKHttpClient创建GET请求步骤如下：

• 通过构建器模式设置读写超时时间，创建出HTTP客户端实例；
• 使用Request.Builder()创建请求实例；
• 使用OkHttpClient.newCall()方法发送异步get请求；
• 通过enqueue()方法设置对异步请求响应的处理。

同步POST请求

OKHttpClient发送同步POST请求代码如下所示：

通过OKHttpClient创建POST请求步骤如下：

• 调用prepaareRequest()方法生成请求JSON数据；
• 通过构建器模式创建出OkHttpClient客户端实例；
• 调用RequestBody.create()创建出请求数据体；
• 调用Request.Builder()构建出POST请求示例；
• 调用execute()发送请求，并同步得到返回结果Response。

OKHttpClient的客户端和请求示例都不需要手动关闭，我们创建单个OkHttpClient实例可以将进行重复使用，并且OkHttp的性能最佳。

Spring WebClient

Spring WebClient是在Spring 5中引入的异步、反应式HTTP客户端，用于取代较旧的RestTemplate，以便在使用Spring Boot框架构建的应用程序中进行REST API调用，它支持同步、异步和流式处理。

同样使用Spring WebClient需要添加Maven依赖：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-webflux</artifactId>
    <version>2.3.5.RELEASE</version>
</dependency>
复制代码

Spring WebClient在Spring-boot-starter-webFlux包中，Spring WebFlux是Spring5的一部分，用于为Web应用程序中的反应式编程提供支持。

异步GET请求

使用Spring WebClient发送异步GET请求代码示例如下：

• 在此代码片段中，我们首先使用默认设置创建客户端；
• 接下来，调用client的get()方法，并调用uri()方法设置请求API地址；
• 调用链中的retrieve()方法用于进行API调用，也就是发送请求；
• 然后并通过bodyToMono()方法获取响应体，该响应体通过bodyToMono()方法转换为Mono对象；
• 最后，使用subscribe()方法以非阻塞方式订阅bodyToMono()方法转换返回的Mono对象。

同步POST请求

虽然Spring WebClient是异步的，但我们仍然可以通过调用block()方法进行同步调用，该方法会阻塞线程，直到执行结束；在方法执行后返回结果。

使用WebClient发出的同步POST请求示例如下：

• 首先通过WebClient.create()创建HTTP客户端；
• 通过client.post()设置请求方式为POST；
• 通过body()方法将prepaareRequest()方法中返回JSON字符串作为请求数据；
• 调用exchange()方法发送请求，并且会将响应数据封装到Mono对象中，比retrieve()方法提供更多的操作方法；
• 调用block()设置请求为同步阻塞的。

如何选择

在本文上述内容中我们通过不同的客户端工具实现了发送同步的GET请求和异步的POST请求。

各个工具的特点可以总结为以下几点：

• 如果不想添加任何外部库并且应用程序的JDK版本是11+，那么原生HTTPClient是首选；

• 如果是Spring Boot应用并且是反应式API，则使用Spring WebClient；

• Apache HttpClient的灵活性更高，相比其他库有更多的参考文档；

• OkHttpClient的性能最佳，客户端对象可重复使用，功能丰富，高度可配置。

所以在实际开发中，按自己的实际需求和场景进行选择，俗话说没有最好的，只有最适合的。

---

我是小黑，一个在互联网“苟且”的程序员。

流水不争先，贵在滔滔不绝