HttpUtil学习笔记

一、功能与特性

请求类型支持

1.1GET 请求：执行 GET 请求非常便捷。例如：

HttpUtil.get("http://example.com/api?param1 = value1 & param2 = value2")；

可以直接向指定的 URL 发送 GET 请求。在这个例子中，查询参数param1和param2直接包含在 URL 中。HttpUtil会自动处理连接建立、发送请求、接收响应等操作，并将服务器的响应以字符串形式返回。

1.2POST 请求

表单数据提交：当需要提交表单数据时，可以使用Map来构建参数。如：

Map<String,Object> paramMap = new HashMap<>();paramMap.put("username", "user1");
paramMap.put("password", "pass1");String response = HttpUtil.post("http://example.com/login", paramMap);

HttpUtil会将paramMap中的键值对按照表单数据的格式进行编码并发送到指定的/login接口，然后返回服务器的响应字符串。

JSON 数据提交：如果要发送 JSON 数据，首先需要将 Java 对象转换为 JSON 字符串（可以借助其他 JSON 库，如FastJSON或者Gson等）。然后可以将 JSON 字符串作为请求体发送。例如：

假设已经有一个 Java 对象User，将其转换为 JSON 字符串，（这里假设使用FastJSON库）。

String jsonStr = JSON.toJSONString(userObject);

然后使用HttpUtil发送 POST 请求：

String response = HttpUtil.post("http://example.com/api/user", jsonStr);

这里HttpUtil会把jsonStr作为请求体发送到指定的/api/user接口。

1.3其他请求类型（PUT、DELETE 等）

虽然在某些场景下 GET 和 POST 请求使用最为频繁，但HttpUtil也支持其他的 HTTP 请求类型。例如，对于 PUT 请求，可以使用HttpUtil.put方法，其使用方式与 POST 请求类似，只是语义上是用于更新资源。对于 DELETE 请求，可以使用HttpUtil.delete方法，用于删除指定的资源。

请求配置

2.1请求头设置

可以通过HttpUtil方便地设置请求头。例如，如果需要设置Content - Type为application/json，可以这样做：

HttpRequest request = HttpUtil.createPost("http://example.com/api");
request.header("Content - Type", "application/json");
String response = request.execute().body();

除了Content - Type，还可以设置其他常见的请求头，如Authorization（用于身份验证）等。这在与需要身份验证或者对请求头有特殊要求的 API 进行交互时非常有用。

2.2超时设置

可以设置连接超时和读取超时时间。例如：HttpUtil.setConnectTimeout(5000);设置连接超时为 5 秒，HttpUtil.setReadTimeout(10000);设置读取超时为 10 秒。这样可以避免在网络连接异常或者服务器响应缓慢的情况下，程序长时间等待而无响应。

代理设置：

在需要通过代理服务器访问目标资源的情况下，HttpUtil支持代理设置。可以通过设置代理的主机地址、端口号等信息来实现。例如：HttpUtil.setProxy(new Proxy(Proxy.Type.HTTP, new InetSocketAddress("proxy.example.com", 8080)));。

响应处理

3.1获取响应内容

无论是 GET 还是 POST 请求等，HttpUtil都会将服务器的响应以字符串形式返回。开发人员可以根据服务器返回的内容格式（如 HTML、JSON、XML 等）进行进一步的解析和处理。例如，如果服务器返回的是 JSON 数据，可以使用 JSON 解析库将字符串解析为 Java 对象进行业务逻辑处理。

3.2获取响应状态码

在处理 HTTP 请求时，响应状态码是判断请求是否成功以及确定错误类型的重要依据。HttpUtil可以方便地获取响应的状态码。例如，在使用HttpRequest对象发送请求时，如：

HttpRequest request = HttpUtil.createPost("http://example.com/api");
String response = request.execute().body();
int statusCode = request.execute().getCode();

可以通过getCode()方法获取响应状态码。这有助于根据状态码进行不同的逻辑处理，如200表示成功，404表示资源未找到，500表示服务器内部错误等。

异常处理

当在发送 HTTP 请求过程中出现问题时，如网络连接中断、域名解析失败、服务器返回错误等，HttpUtil会抛出异常。开发人员可以在代码中使用try - catch块来捕获这些异常并进行相应的处理。例如：

try { 
    String response = HttpUtil.get("http://example.com/api"); 
} catch (Exception e) { 
    System.out.println("HTTP请求发生错误：" + e.getMessage());
  }

二、内部实现原理（简要）

基于 Java 原生网络库（java.net或 java.nio）

HttpUtil在底层是基于 Java 原生的网络库构建的。它利用java.net或java.nio中的类（如Socket、HttpURLConnection或者HttpClient等相关类）来建立网络连接、发送请求和接收响应。这些原生库提供了基本的网络操作功能，HttpUtil在其基础上进行封装，提供了更加易用的接口。

连接池管理（可能）

为了提高性能，尤其是在高并发场景下，HttpUtil可能内部实现了连接池管理机制。当发送多个 HTTP 请求时，通过复用已有的连接而不是每次都重新建立连接，可以大大提高效率。这样可以减少连接建立和释放所带来的开销，节省系统资源并提高请求的响应速度。

三、适用场景

Web 服务交互

在 Java 应用程序与 Web 服务（如 RESTful API）进行交互时，HttpUtil是一个非常实用的工具。无论是从客户端应用向服务器端获取数据（如查询用户信息、获取商品列表等），还是向服务器端提交数据（如用户注册、订单提交等），都可以方便地使用HttpUtil来实现 HTTP 请求的发送和响应的接收。

数据采集与爬虫开发

在数据采集项目或者网络爬虫开发中，需要频繁地向目标网站发送 HTTP 请求来获取网页内容。HttpUtil可以简化这个过程，通过发送 GET 请求获取网页的 HTML 内容，然后再利用 HTML 解析库（如Jsoup等）来提取所需的信息。

微服务通信

在微服务架构中，不同的微服务之间通常通过 HTTP 协议进行通信。HttpUtil可以用于微服务之间的请求发送和响应接收，方便在各个微服务之间传递数据、调用服务接口等操作。