当前位置：首页 > article >正文

Java常用类（一）：HttpClient4.2 Fluent API 的简单了解

article 2025/9/16 1:39:52

1. 什么是HttpClient

1.1 定义

1.2 基本功能

2. 什么是HttpClient Fluent API（流式接口）

2.1 定义

2.2 示例：Fluent API 执行简单的 HTTP 请求

2.3 如果是Maven项目，则pom.xml配置文件中直接引入依赖包即可

1. 什么是HttpClient

1.1 定义

虽然在 JDK 的 java.net 包中已经提供了访问 HTTP 协议的基本功能，但是对于大部分应用程序来说，JDK 库本身提供的功能还不够丰富和灵活。

HttpClient 是 Apache Jakarta Common 下的子项目，用来提供高效的、最新的、功能丰富的，支持 HTTP 协议的客户端编程工具包，并且它支持HTTP协议最新的版本和建议。

1.2 基本功能

官网 HttpClient - HttpClient Home

（1）实现了所有 HTTP 的方法（GET、POST、PUT、DELETE、HEAD、OPTIONS 等）。

（2）支持 HTTPS 协议。

（3）支持代理服务器（Nginx等）。

（4）支持自动（跳转）转向。

2. 什么是HttpClient Fluent API（流式接口）

2.1 定义

4.2版本的 HttpClient 带来了一组非常容易使用的流式API(Fluent API) 接口。

暴露的流式API(Fluent API) 接口中仅仅是 HttpClient 最基本的一些功能，这些接口是在不需要使用

HttpClient 丰富的灵活性时，为了一些简单的功能而准备的。

2.2 示例：Fluent API 执行简单的 HTTP 请求

import org.apache.http.HttpVersion;
import org.apache.http.client.fluent.Request;
import org.apache.http.entity.ContentType;import java.io.IOException;public class FluentRequests {public static void main(String[] args) throws IOException {String str = Request.Get("https://www.baidu.com").connectTimeout(5000).socketTimeout(5000).execute().returnContent().asString();System.out.println("*******************************************");System.out.println(str);byte[] bytes = Request.Post("https://blog.csdn.net/sulia1234567890/article/details/120509672").useExpectContinue().version(HttpVersion.HTTP_1_1).bodyString("Important stuff", ContentType.DEFAULT_TEXT).execute().returnContent().asBytes();System.out.println("*******************************************");System.out.println(bytes);//Execute a POST with a custom header through the proxy containing a request body. as an HTML form and save the result to the file.//Request.Post("http://somehost/some-form")//        .addHeader("X-Custom-header", "stuff")//        .viaProxy(new HttpHost("myproxy", 8080))//        .bodyForm(Form.form().add("username", "vip").add("password", "secret").build())//        .execute().saveContent(new File("result.dump"));//使用 Executor 在特定的需要安全认证的上下文中请求时，认证信息可以被缓存起来，这样后来的请求也可以重复使用认证信息了。后续补代码//响应处理//流式接口(Fluent API) 增加了使用者对连接的管理和资源的分配上的便利性。在许多场景下，在内存中缓存过多的响应内容也会让它付出了相应的代价。因此它推荐使用 ResponseHandler 来处理 HTTP 响应以此来避免在内存中缓存响应内容。后续补代码}
}

结果输出：

*******************************************
<!DOCTYPE html>
<html> <head><meta http-equiv=content-type content=text/html;charset=utf-

（省略一部分打印内容）

src=//www.baidu.com/img/gs.gif> </p> </div> </div> </div> </body> </html>

*******************************************

（省略一部分打印内容）

2.3 如果是Maven项目，则pom.xml配置文件中直接引入依赖包即可

<!-- https://mvnrepository.com/artifact/org.apache.httpcomponents/httpclient -->
<dependency><groupId>org.apache.httpcomponents</groupId><artifactId>httpclient</artifactId><version>4.5.13</version>
</dependency><!-- https://mvnrepository.com/artifact/org.apache.httpcomponents/fluent-hc -->
<dependency><groupId>org.apache.httpcomponents</groupId><artifactId>fluent-hc</artifactId><version>4.5.13</version>
</dependency>

如果只是普通项目，可以根据该文所示，手动导入相关的jar包

可参考：如何在IDEA中添加jar包到 External Libraries 库