了解Hutool Http

Hutool Http 模塊是 Hutool 工具庫的一個子模塊。Hutool 是一個全能的 Java 工具類庫，包含了大量的工具類封裝，方便 Java 開發人員使用。Hutool Http 可以完成 HTTP 請求、HTTP 響應和 HTTP 異常的處理，提供了很多便捷的方法，比如 HttpUtil、HtmlUtil 等等。本文將從多個方面闡述 Hutool Http 的用法和功能。

一、快速使用

在使用 Hutool Http 模塊完成 HTTP 請求之前，先使用 Maven 進行依賴引入：

<dependency>
    <groupId>cn.hutool</groupId>
    <artifactId>hutool-http</artifactId>
    <version>x.x.x</version>
</dependency>

其中 x.x.x 為版本號。引入依賴後，就可以在項目中使用 Hutool Http 提供的各種 http 請求、響應和異常處理工具類。

Hutool Http 提供了非常簡潔的請求接口，可以幫助我們快速實現 http 請求。直接調用 HttpUtil 類的方法就可以發起請求：

//get方法
String result = HttpUtil.get("https://www.hutool.cn/?page=1&size=20", CharsetUtil.CHARSET_UTF_8);
//post方法
String result = HttpUtil.post("https://www.hutool.cn/auth", paramMap);

使用上述代碼即可完成 HTTP GET 和 POST 請求。其中第二個參數是編碼格式需要根據實際情況進行設置，另外參數 paramMap 是一個 Map 對象，表示 post 請求中要發送的請求參數。這樣就能夠輕鬆地完成 HTTP 請求了。

二、HTTP 連接池

在進行 http 請求時，每次都新建一個連接是非常消耗資源的。為了充分利用已經存在的連接，Hutool Http 提供了 HTTP 連接池功能，可以有效地減少http 請求的資源消耗。

我們可以通過調用 HttpUtil.createPoolingClientBuilder() 方法創建鏈接池管理器，從而重複利用已有的連接。

PoolingHttpClientBuilder builder = HttpUtil.createPoolingClientBuilder();
CloseableHttpClient httpClient = builder.build();
HttpUtil httpUtil = new HttpUtil(httpClient);

上面的代碼中，我們通過 HttpUtil.createPoolingClientBuilder() 方法創建了一個連接池管理器，然後通過 builder.build() 方法得到了一個連接池。最後，再通過 HttpUtil 的構造方法將前面得到的 httpClient 設置到 httpUtil 中。

三、文件上傳

除了能夠完成 HTTP 請求的發送和處理，Hutool Http 還提供了文件上傳的功能。我們可以通過 HttpUtil.createPost(String, Map<String, Object>, Map<String, File>>) 方法完成文件上傳，其中第一個參數為上傳地址，第二個參數表示需要傳遞的參數，第三個參數表示需要上傳的文件。

File file = new File("D:/example.txt");
Map<String, File> fileParamMap = new HashMap<>();
fileParamMap.put("file", file);
String result = HttpUtil.createPost("http://localhost:8080/upload", null, fileParamMap).execute().body();

上述代碼中，我們首先創建了一個文件 file，然後使用 HttpUtil.createPost() 方法上傳文件，並返回上傳結果，最後將結果輸出。

四、超時設置

在進行 http 請求的過程中，如果因為網絡問題導致請求超時，請求就會失敗。為了避免這樣的情況發生，Hutool Http 提供了超時設置功能，可以讓我們對請求進行更為靈活和全面的控制。

超時設置包括以下三個方面：

連接超時：即設置建立連接超時時間。
讀取超時：即設置連接超時時間。
請求超時：即設置從連接池中獲得連接的超時時間。

使用 Hutool Http 進行超時設置時，首先要創建一個 HttpRequest 對象，然後根據需要設置各種參數。

HttpRequest request = HttpUtil.createGet("https://www.hutool.cn/");
// 連接超時5秒
request.setConnectionTimeout(5000); 
// 讀取超時10秒
request.setSocketTimeout(10000); 
// 請求超時15秒
request.setRequestTimeout(15000); 
// 發送請求
HttpResponse response = request.execute();

通過調用 setConnectionTimeout()、setSocketTimeout() 和 setRequestTimeout() 方法，我們就可以設置連接超時、讀取超時和請求超時了。

五、HTTP 響應處理

在進行 HTTP 請求之後，不僅需要考慮請求發送的過程，還需要考慮請求響應的過程，因此，為了更好地處理請求響應，Hutool Http 提供了響應處理功能，可以讓我們對請求返回的結果進行更加靈活的處理。

首先，我們發出一個 GET 請求，得到響應結果之後，可以通過 response.getStatus() 方法得到響應碼，通過 response.getHeaders() 方法得到響應頭，通過 response.body() 方法得到響應內容。下面是完整的代碼示例：

HttpRequest request = HttpUtil.createGet("https://www.hutool.cn/");
HttpResponse response = request.execute();
// 獲取響應狀態碼
int status = response.getStatus();
// 獲取響應頭信息
String contentType = response.getHeader("Content-Type");
// 獲取響應內容
String content = response.body();

可以看到，我們可以使用 response.getStatus()、response.getHeader() 和 response.body() 三個方法獲取響應狀態碼、響應頭信息和響應內容；從這些信息中，我們可以得到比較全面的響應結果。

六、異常處理

在進行 http 請求時，可能會出現各種異常情況，為了更好地處理這些異常，Hutool Http 提供了異常處理功能。

Hutool Http 的異常分為以下幾類：

HttpException：Http 請求異常。
HttpConnectException：Http 連接異常。
HttpClientException：Http 客戶端異常。
HttpServerException：Http 服務端異常。

其中 HttpServerException 和 HttpClientException 是 IOException 的子類，因此可以使用 try catch 對它們進行捕獲。下面是一段簡單的代碼示例，演示了如何進行異常處理：

try {
    HttpResponse response = HttpUtil.get("https://www.hutool.cn/");
} catch (HttpException e) {
    // Http 異常
    e.printStackTrace();
} catch (HttpConnectException e) {
    // Http 連接異常
    e.printStackTrace();
} catch (HttpClientException e) {
    // Http 客戶端異常
    e.printStackTrace();
} catch (HttpServerException e) {
    // Http 服務端異常
    e.printStackTrace();
}

七、總結

本文對 Hutool Http 模塊進行了多方面的闡述，從快速使用、HTTP 連接池、文件上傳、超時設置、HTTP 響應處理和異常處理等多個方面介紹了 Hutool Http 的用法和功能。相信通過這篇文章的介紹，讀者可以更好地掌握 Hutool Http 的應用。

原創文章，作者：小藍，如若轉載，請註明出處：https://www.506064.com/zh-hk/n/152100.html