目錄
一、前言介紹
二、主要特點
三、功能用法?
四、應用場景???
五、最佳實踐
六、總結歸納
一、前言介紹
? ? ? ?HttpClient 是一個用于發送 HTTP 請求和接收 HTTP 響應的客戶端庫，廣泛應用于 Web 開發、API 調用、微服務通信等場景。
二、主要特點
-
支持多種HTTP方法：GET、POST、PUT、DELETE等
-
異步操作：支持異步請求模式
-
請求/響應處理：可自定義請求頭和讀取響應內容
-
連接管理：支持連接池和持久連接
三、功能用法?
1.?基本 HTTP 請求?
HttpClient 支持所有 HTTP 方法，包括： ?
-
GET：獲取資源 ?
-
POST：提交數據 ?
-
PUT：更新資源 ?
-
DELETE：刪除資源 ?
-
PATCH：部分更新 ?
示例（GET & POST 請求）：
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;// 創建 HttpClient
HttpClient client = HttpClient.newHttpClient();// GET 請求
HttpRequest getRequest = HttpRequest.newBuilder().uri(URI.create("https://jsonplaceholder.typicode.com/posts/1")).build();
HttpResponse<String> getResponse = client.send(getRequest, HttpResponse.BodyHandlers.ofString());
System.out.println(getResponse.body());// POST 請求（提交 JSON 數據）
String postData = "{\"title\":\"foo\", \"body\":\"bar\", \"userId\":1}";
HttpRequest postRequest = HttpRequest.newBuilder().uri(URI.create("https://jsonplaceholder.typicode.com/posts")).header("Content-Type", "application/json").POST(HttpRequest.BodyPublishers.ofString(postData)).build();
HttpResponse<String> postResponse = client.send(postRequest, HttpResponse.BodyHandlers.ofString());
System.out.println(postResponse.body());2. 高級功能
-
自定義請求頭（如 `Authorization`、`User-Agent`） ?
-
超時控制（避免請求長時間阻塞） ?
-
代理設置（適用于企業內網環境） ?
-
文件上傳/下載（支持 `MultipartFormData`） ?
-
Cookie 管理（適用于需要會話保持的場景） ?
// 設置請求頭
HttpRequest request = HttpRequest.newBuilder().uri(URI.create("https://api.example.com/data")).header("Authorization", "Bearer token123").header("User-Agent", "MyApp/1.0").timeout(Duration.ofSeconds(10)).build();四、應用場景???
1.Web API 調用
-
調用 RESTful API（如 GitHub API、Twitter API） ?
-
與后端服務交互（如微服務架構中的服務間通信） ?
2.爬蟲 & 數據抓取
-
爬取網頁內容（如新聞、電商數據） ?
-
自動化測試（模擬 HTTP 請求） ?
3.文件上傳/下載
-
上傳圖片、視頻到云存儲（如 AWS S3、阿里云 OSS） ?
-
下載遠程文件（如 PDF、Excel 報表） ?
4.身份認證 & OAuth
-
使用 `Bearer Token` 訪問受保護的 API ?
-
實現 OAuth 2.0 授權流程 ?
五、最佳實踐
1.使用單例模式（避免頻繁創建）
- HttpClient 內部管理 TCP 連接，頻繁創建會導致性能問題。 ?
// Java 11+ 的 HttpClient 是線程安全的
HttpClient client = HttpClient.newHttpClient();2.設置合理的超時時間
- 避免因網絡問題導致線程阻塞。 ?
// Java 示例
HttpRequest request = HttpRequest.newBuilder().timeout(Duration.ofSeconds(30)).build();3.異常處理?
- 網絡異常（如 `HttpRequestException`） ?
- HTTP 錯誤狀態碼（如 404、500） ?
try {HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());if (response.statusCode() >= 400) {System.err.println("請求失敗: " + response.statusCode());} else {System.out.println(response.body());}
} catch (IOException | InterruptedException ex) {System.err.println("請求異常: " + ex.getMessage());
}4.使用 `using` 或 `try-with-resources` 釋放資源
- 避免內存泄漏（特別是在 Java 中）。 ?
try (HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString())) {System.out.println(response.body());
}六、總結歸納
| 方面 | 關鍵點 |
|---|---|
| 功能 | 支持 GET/POST/PUT/DELETE、自定義 Header、超時控制、文件上傳/下載 |
| 應用場景 | API 調用、爬蟲、微服務通信、文件傳輸 |
| 最佳實踐 | 單例模式、超時設置、異常處理、資源釋放 |
-
HttpClient 是現代化 HTTP 通信的核心工具，合理使用可以提升應用的穩定性和性能。
