HttpClientUtil：優秀的 Java HTTP 客戶端工具類

HttpClientUtil 是一個基於 HttpClient 4.x 的 Java HTTP 客戶端工具類，功能強大，易於使用。在使用 HttpClientUtil 進行 HTTP 請求時，我們可以比較方便地進行請求參數的配置、進行文件上傳、設置代理、設置連接池等，從而滿足我們的各種需求。本文將從多個方面對 HttpClientUtil 進行詳細的闡述。

一、HttpClientUtil 的基本使用

HttpClientUtil 的基本使用主要包括創建 HttpClientUtil 對象、設置請求參數以及執行 HTTP 請求三步。

    //創建 HttpClientUtil 對象
    HttpClientUtil httpClientUtil = new HttpClientUtil();

    //設置請求參數
    Map<String, Object> params = new HashMap<>();
    params.put("param1", "value1");
    params.put("param2", "value2");

    //執行 HTTP 請求，返回結果
    String result = httpClientUtil.sendHttpPost("http://example.com", params);

在上述代碼中，我們首先創建了一個 HttpClientUtil 對象。然後，我們設置了請求參數，這裡我們使用了一個 Map 對象來存儲請求參數。最後，我們調用 HttpClientUtil 的 sendHttpPost 方法執行 HTTP 請求，並將結果保存在 result 字符串中。

二、設置代理

有時候，我們需要設置代理，以便讓 HTTP 請求走代理服務器。使用 HttpClientUtil 可以比較方便地實現這一功能。

    //創建 HttpClientUtil 對象，並設置代理
    HttpClientUtil httpClientUtil = new HttpClientUtil("http://proxy.example.com", 8080);

    //設置請求參數
    Map<String, Object> params = new HashMap<>();
    params.put("param1", "value1");
    params.put("param2", "value2");

    //執行 HTTP 請求，返回結果
    String result = httpClientUtil.sendHttpPost("http://example.com", params);

在上述代碼中，我們使用 HttpClientUtil 的構造方法創建了一個 HttpClientUtil 對象，並設置了代理服務器的地址和端口號。之後的操作與基本使用相同。

三、進行文件上傳

使用 HttpClientUtil 進行文件上傳非常方便，我們只需要指定文件的路徑即可。

    //創建 HttpClientUtil 對象
    HttpClientUtil httpClientUtil = new HttpClientUtil();

    //設置 POST 請求的參數
    Map<String, Object> params = new HashMap<>();
    params.put("param1", "value1");
    params.put("param2", "value2");

    //設置上傳文件的路徑
    List<String> fileList = new ArrayList<>();
    fileList.add("/home/user1/Pictures/image1.jpg");
    fileList.add("/home/user1/Pictures/image2.jpg");
    
    //執行 HTTP 請求，返回結果
    String result = httpClientUtil.sendHttpPostWithFile("http://example.com", params, fileList);

在上述代碼中，我們使用 HttpClientUtil 的 sendHttpPostWithFile 方法進行文件上傳。我們將上傳文件的路徑以 List<String> 的形式傳遞給該方法。另外，我們也可以使用 sendHttpGetWithFile 方法進行文件下載操作。

四、設置連接池

使用 HttpClientUtil 進行 HTTP 請求時，如果請求頻繁，建議使用連接池來提升性能。

    //創建連接池
    ConnectionPoolManager connectionPoolManager = new ConnectionPoolManager();

    //設置連接池的最大連接數和每個路由的最大連接數
    connectionPoolManager.setMaxTotal(200);
    connectionPoolManager.setDefaultMaxPerRoute(20);

    //創建 HttpClientUtil 對象，並使用連接池
    HttpClientUtil httpClientUtil = new HttpClientUtil(connectionPoolManager);

    //設置請求參數
    Map<String, Object> params = new HashMap<>();
    params.put("param1", "value1");
    params.put("param2", "value2");

    //執行 HTTP 請求，返回結果
    String result = httpClientUtil.sendHttpPost("http://example.com", params);

在上述代碼中，我們首先創建了一個 ConnectionPoolManager，然後使用 setMaxTotal 和 setDefaultMaxPerRoute 方法設置了連接池的最大連接數和每個路由的最大連接數。之後，我們創建了一個 HttpClientUtil 對象，並將 ConnectionPoolManager 對象傳遞給 HttpClientUtil 的構造方法以使用連接池。

五、HttpClientUtil 的異常處理

使用 HttpClientUtil 進行 HTTP 請求時，我們需要注意異常的處理，以便進行錯誤恢復。下面是一些常見的異常情況及其處理方法。

1、在訪問 HTTP 網站時，可能會遇到重定向異常。

    try {
        HttpClientUtil httpClientUtil = new HttpClientUtil();
        String url = "http://example.com";
        String result = httpClientUtil.sendHttpGet(url);
        System.out.println(result);
    } catch (RedirectException e) {
        System.out.println("該網站已重定向至：" + e.getLocationURI());
    }

在該例子中，我們捕獲了 RedirectException 異常，打印出了重定向後的 URL。

2、在請求 HTTPS 網站時，可能會遇到證書驗證異常。

    try {
        HttpClientUtil httpClientUtil = new HttpClientUtil();
        String url = "https://example.com";
        String result = httpClientUtil.sendHttpGet(url);
        System.out.println(result);
    } catch (SSLHandshakeException e) {
        System.out.println("SSL 證書驗證失敗：" + e.getMessage());
    }

在該例子中，我們捕獲了 SSLHandshakeException 異常，打印出了證書驗證失敗的原因。

總結

HttpClientUtil 是一個強大的 Java HTTP 客戶端工具類，可以滿足我們各種複雜的 HTTP 請求需求。在使用 HttpClientUtil 進行 HTTP 請求時，我們可以方便地設置請求參數、進行文件上傳、設置代理、設置連接池等，使得我們的代碼變得簡潔、高效。同時，我們也需要注意 HttpClientUtil 的異常處理，以便進行錯誤恢復。