Apache?HttpClient使用實例詳解
更新時間：2025年03月26日 09:28:25 作者：kmt-碼上解決
ApacheHttpClient是一個強大的Java?HTTP客戶端庫,用于發(fā)送HTTP請求并處理響應,HttpClients提供了多種方法來創(chuàng)建和配置HTTP客戶端實例,本文給大家介紹Apache?HttpClient使用示例詳解,感興趣的朋友一起看看吧
一、Apache HttpClient 基礎版
HttpClients 是 Apache HttpClient 庫中的一個工具類，用于創(chuàng)建和管理 HTTP 客戶端實例。Apache HttpClient 是一個強大的 Java HTTP 客戶端庫，用于發(fā)送 HTTP 請求并處理 HTTP 響應。HttpClients 提供了多種方法來創(chuàng)建和配置 HTTP 客戶端實例。
以下是關于 HttpClients 的詳細講解：
1. Apache HttpClient 簡介
Apache HttpClient 是一個開源的 Java HTTP 客戶端庫，支持 HTTP/1.1 和 HTTP/2 協(xié)議。它提供了豐富的功能，例如：
- 發(fā)送 GET、POST、PUT、DELETE 等 HTTP 請求。
- 處理 HTTP 請求和響應的頭部、狀態(tài)碼、實體等。
- 支持連接池、重試機制、代理、SSL/TLS 等高級功能。
2. HttpClients 類的作用
HttpClients 是一個工廠類，用于創(chuàng)建 CloseableHttpClient 實例。CloseableHttpClient 是 HTTP 客戶端的主要接口，用于執(zhí)行 HTTP 請求。
HttpClients 提供了多種靜態(tài)方法來創(chuàng)建和配置 HTTP 客戶端實例，例如：
- 創(chuàng)建默認的 HTTP 客戶端。
- 創(chuàng)建自定義配置的 HTTP 客戶端。
- 創(chuàng)建支持連接池的 HTTP 客戶端。
3. HttpClients 的常用方法
(1) HttpClients.createDefault()
- 功能： 創(chuàng)建一個默認的 HTTP 客戶端實例。
- 特點：
- 使用默認的配置（例如連接池、重試機制等）。
- 適合大多數(shù)簡單的 HTTP 請求場景。
- 示例：
CloseableHttpClient httpClient = HttpClients.createDefault();
(2) HttpClients.createSystem()
- 功能： 創(chuàng)建一個基于系統(tǒng)屬性的 HTTP 客戶端實例。
- 特點：
- 使用系統(tǒng)屬性（例如代理設置、超時時間等）來配置客戶端。
- 適合需要與系統(tǒng)配置集成的場景。
- 示例：
CloseableHttpClient httpClient = HttpClients.createSystem();
(3) HttpClients.custom()
- 功能： 返回一個
HttpClientBuilder對象，用于自定義配置 HTTP 客戶端。 - 特點：
- 可以設置連接池、超時時間、代理、SSL/TLS 等高級配置。
- 適合需要精細控制的場景。
- 示例：
CloseableHttpClient httpClient = HttpClients.custom()
.setMaxConnTotal(100) // 最大連接數(shù)
.setMaxConnPerRoute(10) // 每個路由的最大連接數(shù)
.build();4. HttpClients 的使用示例
以下是一個完整的示例，展示如何使用 HttpClients 發(fā)送 HTTP GET 請求并處理響應：
import org.apache.http.client.methods.CloseableHttpResponse;
import org.apache.http.client.methods.HttpGet;
import org.apache.http.impl.client.CloseableHttpClient;
import org.apache.http.impl.client.HttpClients;
import org.apache.http.util.EntityUtils;
?
public class HttpClientExample {
public static void main(String[] args) {
// 1. 創(chuàng)建 HTTP 客戶端
try (CloseableHttpClient httpClient = HttpClients.createDefault()) {
// 2. 創(chuàng)建 HTTP GET 請求
HttpGet request = new HttpGet("https://jsonplaceholder.typicode.com/posts/1");
?
// 3. 發(fā)送請求并獲取響應
try (CloseableHttpResponse response = httpClient.execute(request)) {
// 4. 檢查響應狀態(tài)碼
int statusCode = response.getStatusLine().getStatusCode();
System.out.println("Status Code: " + statusCode);
?
// 5. 獲取響應內容
String responseBody = EntityUtils.toString(response.getEntity());
System.out.println("Response Body: " + responseBody);
}
} catch (Exception e) {
e.printStackTrace();
}
}
}5. HttpClients 的高級配置
通過 HttpClients.custom() 方法，可以自定義 HTTP 客戶端的配置。以下是一些常見的配置選項：
(1) 連接池配置
CloseableHttpClient httpClient = HttpClients.custom()
.setMaxConnTotal(100) // 最大連接數(shù)
.setMaxConnPerRoute(10) // 每個路由的最大連接數(shù)
.build();(2) 超時配置
RequestConfig requestConfig = RequestConfig.custom()
.setConnectTimeout(5000) // 連接超時時間
.setSocketTimeout(5000) // 讀取超時時間
.build();
?
CloseableHttpClient httpClient = HttpClients.custom()
.setDefaultRequestConfig(requestConfig)
.build();(3) 代理配置
HttpHost proxy = new HttpHost("proxy.example.com", 8080);
?
CloseableHttpClient httpClient = HttpClients.custom()
.setProxy(proxy)
.build();(4) SSL/TLS 配置
SSLContext sslContext = SSLContexts.custom()
.loadTrustMaterial((chain, authType) -> true) // 信任所有證書
.build();
?
CloseableHttpClient httpClient = HttpClients.custom()
.setSSLContext(sslContext)
.build();6. 注意事項
資源釋放： CloseableHttpClient 和 CloseableHttpResponse 都實現(xiàn)了 Closeable 接口，使用后需要關閉以釋放資源。
線程安全： CloseableHttpClient 是線程安全的，可以在多線程環(huán)境中共享。
性能優(yōu)化： 使用連接池和合理的超時配置可以顯著提升性能。
7. 總結
HttpClients是 Apache HttpClient 庫中的一個工具類，用于創(chuàng)建和管理 HTTP 客戶端實例。- 它提供了多種方法來創(chuàng)建默認或自定義配置的 HTTP 客戶端。
- 通過
HttpClients.custom()方法，可以實現(xiàn)連接池、超時、代理、SSL/TLS 等高級配置。 - 使用 Apache HttpClient 可以輕松發(fā)送 HTTP 請求并處理響應，是 Java 中處理 HTTP 請求的強大工具。
二、Apache HttpClient 高級版
1. HttpClients 類概述
HttpClients 是 Apache HttpClient 庫中的一個工廠類，用于創(chuàng)建和配置 CloseableHttpClient 實例。它是構建 HTTP 客戶端的入口點，支持高度自定義的 HTTP 請求處理，包括連接池管理、SSL/TLS 配置、重試機制等。
2. 核心方法與配置
2.1 創(chuàng)建默認客戶端
CloseableHttpClient httpClient = HttpClients.createDefault();
特點：
- 使用默認的配置（連接池、請求重試等）。
- 適合簡單場景，但擴展性有限。
2.2 自定義配置客戶端
通過 HttpClients.custom() 返回 HttpClientBuilder，允許精細化配置：
CloseableHttpClient httpClient = HttpClients.custom()
.setConnectionManager(connectionManager) // 連接池管理
.setDefaultRequestConfig(requestConfig) // 請求超時配置
.setRetryHandler(retryHandler) // 請求重試策略
.setProxy(proxy) // 代理設置
.setSSLContext(sslContext) // SSL/TLS 配置
.build();3. 高級配置詳解
3.1 連接池管理
連接池是提升性能的關鍵組件，避免頻繁創(chuàng)建和銷毀連接。
PoolingHttpClientConnectionManager connectionManager =
new PoolingHttpClientConnectionManager();
connectionManager.setMaxTotal(200); // 最大總連接數(shù)
connectionManager.setDefaultMaxPerRoute(20); // 每個路由（目標主機）的最大連接數(shù)
?
CloseableHttpClient httpClient = HttpClients.custom()
.setConnectionManager(connectionManager)
.build();3.2 超時配置
RequestConfig requestConfig = RequestConfig.custom()
.setConnectTimeout(5000) // 連接建立超時時間（毫秒）
.setSocketTimeout(10000) // 數(shù)據(jù)傳輸超時時間（毫秒）
.setConnectionRequestTimeout(2000) // 從連接池獲取連接的超時時間
.build();
?
CloseableHttpClient httpClient = HttpClients.custom()
.setDefaultRequestConfig(requestConfig)
.build();3.3 重試機制
自動重試失敗的請求（例如網絡波動導致失?。?/p>
HttpRequestRetryHandler retryHandler = (exception, executionCount, context) -> {
if (executionCount >= 3) return false; // 最大重試次數(shù)
if (exception instanceof NoHttpResponseException) return true; // 無響應時重試
return false;
};
?
CloseableHttpClient httpClient = HttpClients.custom()
.setRetryHandler(retryHandler)
.build();3.4 代理配置
HttpHost proxy = new HttpHost("proxy.example.com", 8080);
CloseableHttpClient httpClient = HttpClients.custom()
.setProxy(proxy)
.build();3.5 SSL/TLS 配置
信任所有證書（僅限測試環(huán)境）：
SSLContext sslContext = SSLContexts.custom()
.loadTrustMaterial((chain, authType) -> true) // 信任所有證書
.build();
?
CloseableHttpClient httpClient = HttpClients.custom()
.setSSLContext(sslContext)
.setSSLHostnameVerifier(NoopHostnameVerifier.INSTANCE) // 跳過主機名驗證
.build();3.6 認證機制
使用 Basic 認證：
CredentialsProvider credentialsProvider = new BasicCredentialsProvider();
credentialsProvider.setCredentials(
new AuthScope("host.example.com", 80),
new UsernamePasswordCredentials("user", "pass")
);
?
CloseableHttpClient httpClient = HttpClients.custom()
.setDefaultCredentialsProvider(credentialsProvider)
.build();4. 請求與響應處理
4.1 發(fā)送 GET 請求
HttpGet httpGet = new HttpGet("https://api.example.com/data");
try (CloseableHttpResponse response = httpClient.execute(httpGet)) {
int statusCode = response.getStatusLine().getStatusCode();
HttpEntity entity = response.getEntity();
String content = EntityUtils.toString(entity);
EntityUtils.consume(entity); // 確保資源釋放
}4.2 發(fā)送 POST 請求（JSON 數(shù)據(jù)）
HttpPost httpPost = new HttpPost("https://api.example.com/create");
StringEntity jsonEntity = new StringEntity("{\"key\":\"value\"}", ContentType.APPLICATION_JSON);
httpPost.setEntity(jsonEntity);
?
try (CloseableHttpResponse response = httpClient.execute(httpPost)) {
// 處理響應...
}4.3 文件上傳（Multipart）
HttpPost httpPost = new HttpPost("https://api.example.com/upload");
FileBody fileBody = new FileBody(new File("path/to/file"));
MultipartEntityBuilder builder = MultipartEntityBuilder.create()
.addPart("file", fileBody)
.addTextBody("comment", "File upload");
httpPost.setEntity(builder.build());5. 高級功能
5.1 異步請求
使用 HttpAsyncClients 實現(xiàn)異步非阻塞請求：
CloseableHttpAsyncClient asyncClient = HttpAsyncClients.custom().build();
asyncClient.start();
?
SimpleHttpRequest request = SimpleHttpRequest.get("https://api.example.com/data");
Future<SimpleHttpResponse> future = asyncClient.execute(request, new FutureCallback<>() {
@Override
public void completed(SimpleHttpResponse response) {
System.out.println("Response: " + response.getBodyText());
}
?
@Override
public void failed(Exception ex) {
ex.printStackTrace();
}
?
@Override
public void cancelled() {
System.out.println("Request cancelled");
}
});5.2 請求攔截器
添加自定義邏輯（如日志記錄、修改請求頭）：
CloseableHttpClient httpClient = HttpClients.custom()
.addInterceptorFirst((HttpRequestInterceptor) (request, context) -> {
request.addHeader("X-Custom-Header", "value");
System.out.println("Request URI: " + request.getRequestLine().getUri());
})
.build();5.3 Cookie 管理
自動管理 Cookie：
CookieStore cookieStore = new BasicCookieStore();
CloseableHttpClient httpClient = HttpClients.custom()
.setDefaultCookieStore(cookieStore)
.build();6. 最佳實踐與常見問題
6.1 資源釋放
確保關閉 CloseableHttpClient 和 CloseableHttpResponse：
try (CloseableHttpClient httpClient = HttpClients.createDefault()) {
try (CloseableHttpResponse response = httpClient.execute(request)) {
// 處理響應...
}
}6.2 性能調優(yōu)
- 連接池參數(shù)：根據(jù)并發(fā)需求調整
MaxTotal和DefaultMaxPerRoute。 - 超時設置：避免因網絡問題導致線程阻塞。
- 重用連接：復用
HttpClient實例而非頻繁創(chuàng)建。
6.3 錯誤處理
- 重試策略：針對可恢復錯誤（如超時）配置自動重試。
- 異常捕獲：處理
IOException、ClientProtocolException等。
6.4 安全性
- 生產環(huán)境禁用信任所有證書：使用有效 CA 簽名的證書。
- 敏感信息保護：避免在日志中打印請求頭或響應體中的敏感數(shù)據(jù)。
7. 典型應用場景
- 微服務間通信：在分布式系統(tǒng)中通過 HTTP 調用其他服務。
- API 集成：調用第三方 RESTful API（如支付網關、地圖服務）。
- 爬蟲開發(fā)：抓取網頁內容并解析數(shù)據(jù)。
- 文件傳輸：上傳/下載文件到遠程服務器。
- 測試自動化：模擬客戶端發(fā)送 HTTP 請求驗證接口功能。
8. 官方文檔與資源
Apache HttpClient 官方文檔： Apache HttpComponents – HttpClient Overview
GitHub 倉庫： https://github.com/apache/httpcomponents-client
到此這篇關于Apache HttpClient使用的文章就介紹到這了,更多相關Apache HttpClient使用內容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關文章希望大家以后多多支持腳本之家！
相關文章
Linux中使用crond工具創(chuàng)建定時任務的方法
這篇文章主要介紹了Linux中使用crond工具創(chuàng)建定時任務的方法，本文通過多種方法給大家介紹的非常詳細，具有一定的參考借鑒價值,需要的朋友可以參考下2020-02-02
NFS 是Network File System的縮寫，即網絡文件系統(tǒng)，可以讓不同的客戶端掛載使用同一個目錄，作為共享存儲使用，這樣可以保證不同的節(jié)點客戶端數(shù)據(jù)一致性，在集群架構中經常用到.這篇文章主要介紹了Linux NFS服務器安裝與配置思路,需要的朋友可以參考下2016-10-10
這篇文章主要介紹了linux開機啟動nodemanager的步驟，大家參考使用吧2014-01-01
這篇文章主要介紹了CentOS 6.8 NFS 文件共享設置的方法，小編覺得挺不錯的，現(xiàn)在分享給大家，也給大家做個參考。一起跟隨小編過來看看吧2018-01-01
本篇文章主要介紹了Linux下淺談crond與crontab的用法，小編覺得挺不錯的，現(xiàn)在分享給大家，也給大家做個參考。一起跟隨小編過來看看吧2017-06-06
CentOS6.4安裝Apache+MySQL+PHP圖文教程
這篇文章主要介紹了CentOS6.4安裝Apache+MySQL+PHP圖文教程，需要的朋友可以參考下。2016-10-10
linux系統(tǒng)下一個冷門的RAID卡ioc0及其監(jiān)控mpt-status
這篇文章主要介紹了linux系統(tǒng)下一個冷門的RAID卡ioc0及其監(jiān)控mpt-status,需要的朋友可以參考下2016-05-05
這篇文章主要介紹了Linux下gdb調試打印進程內存信息方式,具有很好的參考價值,希望對大家有所幫助,如有錯誤或未考慮完全的地方,望不吝賜教2023-09-09
centos7系統(tǒng)nginx服務器下phalcon環(huán)境搭建方法詳解
這篇文章主要介紹了centos7系統(tǒng)nginx服務器下phalcon環(huán)境搭建方法,結合具體實例形式詳細分析了centos7的nginx服務器搭建phalcon的具體操作步驟與相關設置技巧,需要的朋友可以參考下2019-09-09
交換內存swap是linux下一個虛擬內存的概念，它是利用磁盤空間虛擬出的一塊邏輯內存，用于解決物理內存容量不足的問題，本文就給大家介紹一下在Linux中如何釋放交換空間swap,需要的朋友可以參考下2023-07-07