使用Apache Httpclient進行HTTP網路請求

使用Java進行網路請求時，Apache Httpclient是一個不錯的選擇。該庫提供了完整而豐富的HTTP客戶端協議支持。它可以輕鬆地完成HTTP請求，並支持各種HTTP協議版本的請求。同時，Apache Httpclient也支持HTTP身份驗證、代理伺服器、Cookie等基礎功能。為了方便學習，我們從以下幾個方面對Apache Httpclient進行詳細闡述。

一、Httpclient的基本使用

使用Apache Httpclient進行網路請求，首先需要創建HttpClient實例，該實例可以被重用。可以通過HttpClientBuilder構造器獲取HttpClient對象。

HttpClient httpClient = HttpClientBuilder.create().build();

創建完HttpClient實例後，就可以開始發起HTTP請求了。發起HTTP請求的第一步是創建HttpRequest對象。具體實現根據請求類型的不同而有所不同，可以通過HttpGet或HttpPost方式進行請求。

HttpGet httpGet = new HttpGet("http://www.google.com");
HttpResponse response = httpClient.execute(httpGet);

上述代碼是一個最基本的例子，可以發起一個GET請求並獲得響應。我們可以將返回的HttpResponse對象用於獲取響應的狀態碼、Header信息和響應體等。

二、請求參數設置

請求參數設置是使用Apache Httpclient進行請求時必不可少的一部分。可以使用HttpUriRequest介面或其子類設置請求參數。

首先，我們可以通過setHeader()方法設置請求頭信息。

HttpGet httpGet = new HttpGet("http://www.google.com");
httpGet.setHeader("User-Agent", "Mozilla/5.0 (Windows NT 6.1; WOW64; rv:77.0) Gecko/20190101 Firefox/77.0");
HttpResponse response = httpClient.execute(httpGet);

上述代碼中，設置了User-Agent請求頭信息。

其次，我們可以使用setEntity()方法設置請求體。

HttpPost httpPost = new HttpPost("https://api.example.com");
StringEntity stringEntity = new StringEntity("Hello, World!", ContentType.APPLICATION_JSON);
httpPost.setEntity(stringEntity);
HttpResponse response = httpClient.execute(httpPost);

上述代碼中，設置了POST請求的請求體信息為JSON格式的字元串”Hello, World!”。

三、響應處理

使用Apache Httpclient獲得響應後，我們需要進行響應處理。最基本的處理方法是根據請求狀態碼判斷請求是否成功完成。可以通過getStatusLine()方法獲取響應狀態碼。

HttpGet httpGet = new HttpGet("http://www.google.com");
HttpResponse response = httpClient.execute(httpGet);
if (response.getStatusLine().getStatusCode() == HttpStatus.SC_OK) {
    //請求成功處理
} else {
    //請求失敗處理
}

除了校驗狀態碼以外，我們還可以通過HttpResponse對象獲取響應內容。可以使用EntityUtils.toString()方法獲取響應體的字元串形式，也可以使用EntityUtils.toByteArray()方法獲取響應體的位元組數組形式。

HttpGet httpGet = new HttpGet("http://www.google.com");
HttpResponse response = httpClient.execute(httpGet);
String responseBody = EntityUtils.toString(response.getEntity());

四、異常處理

在使用Apache Httpclient進行網路請求時，我們不能保證每次請求都是成功的。因此，我們需要對請求異常進行處理。可以使用HttpRetryException、HttpHostConnectException等異常類來進行具體的異常處理。

try {
    HttpGet httpGet = new HttpGet("http://www.google.com");
    HttpResponse response = httpClient.execute(httpGet);
} catch (HttpHostConnectException e) {
    //處理連接失敗異常
} catch (HttpRetryException e) {
    //處理請求重試異常
}

五、高級使用

在使用Apache Httpclient時，我們還可以使用連接池技術、非同步請求等高級功能，以提升程序性能和用戶體驗。

連接池技術可以降低資源消耗，並且加快請求的響應時間。可以使用PoolingHttpClientConnectionManager類的對象來進行連接池的管理。

PoolingHttpClientConnectionManager cm = new PoolingHttpClientConnectionManager();
cm.setMaxTotal(200);
cm.setDefaultMaxPerRoute(20);
HttpClient httpClient = HttpClientBuilder.create().setConnectionManager(cm).build();

上述代碼創建了一個連接池管理對象，並為最大連接數設定了200，同時設置每個路由器對應的默認最大連接數為20。

非同步請求可以防止阻塞主線程，以保證用戶交互過程的流暢性。非同步請求可以使用FutureCallback介面來進行處理。

Future future = httpClient.execute(request, new FutureCallback() {
    @Override
    public void completed(HttpResponse response) {
        //請求成功處理
    }

    @Override
    public void failed(Exception ex) {
        //請求失敗處理
    }

    @Override
    public void cancelled() {
        //請求取消處理
    }
});

上述代碼中，使用execute()方法發起非同步請求，FutureCallback介面可以用於處理非同步請求操作的成功、失敗和取消等情況。

六、總結

本文對Apache Httpclient進行了詳細介紹，從基本使用、請求參數設置、響應處理、異常處理等方面進行了闡述。同時，我們還提及了高級使用中的連接池技術和非同步請求等內容，以便讀者更好地掌握Apache Httpclient的使用。