- 传统且强大的方式:使用
HttpURLConnection(JDK 自带) 或 Apache HttpClient (第三方库)。 - 现代且便捷的方式:使用 Java 11+ 引入的
java.net.http.HttpClient(JDK 自带)。
下面我将逐一介绍这些方法,并提供代码示例。

HttpURLConnection (JDK 内置)
这是 Java 标准库中最传统的方式,无需添加任何依赖,它的 API 相对底层,需要手动处理很多细节,比如流、连接状态码等。
主要特点:
- 优点:JDK 自带,无需额外依赖。
- 缺点:API 繁琐,功能有限(异步支持不友好),代码冗长。
示例代码:发送 GET 请求
import java.io.BufferedReader;
import java.io.IOException;
import java.io.InputStreamReader;
import java.net.HttpURLConnection;
import java.net.URL;
public class HttpURLConnectionExample {
public static void main(String[] args) {
String urlString = "https://jsonplaceholder.typicode.com/posts/1";
try {
// 1. 创建 URL 对象
URL url = new URL(urlString);
// 2. 打开连接
HttpURLConnection connection = (HttpURLConnection) url.openConnection();
// 3. 设置请求方法
connection.setRequestMethod("GET");
// 4. 设置请求头 (可选)
connection.setRequestProperty("User-Agent", "Mozilla/5.0");
connection.setRequestProperty("Accept", "application/json");
// 5. 获取响应码
int responseCode = connection.getResponseCode();
System.out.println("Response Code: " + responseCode);
// 6. 读取响应数据
if (responseCode == HttpURLConnection.HTTP_OK) { // 200
BufferedReader in = new BufferedReader(
new InputStreamReader(connection.getInputStream()));
String inputLine;
StringBuilder response = new StringBuilder();
while ((inputLine = in.readLine()) != null) {
response.append(inputLine);
}
in.close();
// 打印结果
System.out.println("Response Body: " + response.toString());
} else {
System.out.println("GET request failed");
}
} catch (IOException e) {
e.printStackTrace();
}
}
}
示例代码:发送 POST 请求
import java.io.OutputStream;
import java.net.HttpURLConnection;
import java.net.URL;
import java.nio.charset.StandardCharsets;
public class HttpURLConnectionPostExample {
public static void main(String[] args) {
String urlString = "https://jsonplaceholder.typicode.com/posts";
String jsonInputString = "{\"title\":\"foo\",\"body\":\"bar\",\"userId\":1}";
try {
URL url = new URL(urlString);
HttpURLConnection connection = (HttpURLConnection) url.openConnection();
// 1. 设置请求方法为 POST
connection.setRequestMethod("POST");
// 2. 设置请求头
connection.setRequestProperty("Content-Type", "application/json; utf-8");
connection.setRequestProperty("Accept", "application/json");
connection.setDoOutput(true); // 允许输出
// 3. 发送请求体
try (OutputStream os = connection.getOutputStream()) {
byte[] input = jsonInputString.getBytes(StandardCharsets.UTF_8);
os.write(input, 0, input.length);
}
// 4. 读取响应
int responseCode = connection.getResponseCode();
System.out.println("POST Response Code: " + responseCode);
if (responseCode == HttpURLConnection.HTTP_CREATED || responseCode == HttpURLConnection.HTTP_OK) { // 201 或 200
// 读取响应体的代码与 GET 示例中相同...
System.out.println("POST request was successful.");
} else {
System.out.println("POST request failed.");
}
} catch (IOException e) {
e.printStackTrace();
}
}
}
Apache HttpClient (第三方库)
这是业界长期以来的事实标准,功能非常强大、灵活且易用,虽然现在 JDK 自带的 HttpClient 也很强大,但很多现有项目仍在使用 Apache HttpClient。
主要特点:
- 优点:功能强大、API 友好、支持连接池、重试机制等。
- 缺点:需要添加 Maven/Gradle 依赖。
Maven 依赖
<dependency>
<groupId>org.apache.httpcomponents.client5</groupId>
<artifactId>httpclient5</artifactId>
<version>5.3.1</version> <!-- 请使用最新版本 -->
</dependency>
示例代码:发送 GET 和 POST 请求
Apache HttpClient 的设计更加面向对象,通过 HttpClient、HttpRequest 和 HttpResponse 对象来操作。
import org.apache.hc.client5.http.classic.methods.HttpGet;
import org.apache.hc.client5.http.classic.methods.HttpPost;
import org.apache.hc.client5.http.impl.classic.CloseableHttpClient;
import org.apache.hc.client5.http.impl.classic.CloseableHttpResponse;
import org.apache.hc.client5.http.impl.classic.HttpClients;
import org.apache.hc.core5.http.HttpEntity;
import org.apache.hc.core5.http.io.entity.StringEntity;
import org.apache.hc.core5.net.URIBuilder;
import java.io.BufferedReader;
import java.io.IOException;
import java.io.InputStreamReader;
import java.net.URI;
import java.net.URISyntaxException;
import java.nio.charset.StandardCharsets;
public class ApacheHttpClientExample {
public static void main(String[] args) {
// --- GET 请求示例 ---
getExample();
// --- POST 请求示例 ---
postExample();
}
public static void getExample() {
String url = "https://jsonplaceholder.typicode.com/posts";
try (CloseableHttpClient httpClient = HttpClients.createDefault()) {
// 构建带查询参数的 URI
URI uri = new URIBuilder(url)
.addParameter("userId", "1")
.build();
HttpGet request = new HttpGet(uri);
request.addHeader("Accept", "application/json");
try (CloseableHttpResponse response = httpClient.execute(request)) {
System.out.println("GET Response Status: " + response.getCode());
HttpEntity entity = response.getEntity();
if (entity != null) {
String result = entity.getContentAsString(StandardCharsets.UTF_8);
System.out.println("GET Response Body: " + result);
}
}
} catch (IOException | URISyntaxException e) {
e.printStackTrace();
}
}
public static void postExample() {
String url = "https://jsonplaceholder.typicode.com/posts";
String jsonBody = "{\"title\":\"foo\",\"body\":\"bar\",\"userId\":1}";
try (CloseableHttpClient httpClient = HttpClients.createDefault()) {
HttpPost post = new HttpPost(url);
// 设置请求体
StringEntity entity = new StringEntity(jsonBody, StandardCharsets.UTF_8);
post.setEntity(entity);
// 设置请求头
post.setHeader("Content-Type", "application/json");
post.setHeader("Accept", "application/json");
try (CloseableHttpResponse response = httpClient.execute(post)) {
System.out.println("POST Response Status: " + response.getCode());
HttpEntity responseEntity = response.getEntity();
if (responseEntity != null) {
String result = responseEntity.getContentAsString(StandardCharsets.UTF_8);
System.out.println("POST Response Body: " + result);
}
}
} catch (IOException e) {
e.printStackTrace();
}
}
}
java.net.http.HttpClient (Java 11+ 推荐)
这是 Java 11 引入的现代 HTTP 客户端,旨在替代老旧的 HttpURLConnection 和提供与第三方库相媲美的功能,它支持同步和异步请求,API 非常现代化。

主要特点:
- 优点:现代化 API、内置异步支持、流畅的链式调用、标准库的一部分。
- 缺点:需要 Java 11 或更高版本。
示例代码:发送 GET 请求
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.time.Duration;
public class JavaHttpClientGetExample {
public static void main(String[] args) throws Exception {
String url = "https://jsonplaceholder.typicode.com/posts/1";
// 1. 创建 HttpClient
HttpClient client = HttpClient.newBuilder()
.version(HttpClient.Version.HTTP_2)
.connectTimeout(Duration.ofSeconds(10))
.build();
// 2. 创建 HttpRequest
HttpRequest request = HttpRequest.newBuilder()
.GET()
.uri(URI.create(url))
.header("Accept", "application/json")
.build();
// 3. 发送请求并获取响应 (同步方式)
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
// 4. 处理响应
System.out.println("Status Code: " + response.statusCode());
System.out.println("Response Body: " + response.body());
}
}
示例代码:发送 POST 请求
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.time.Duration;
public class JavaHttpClientPostExample {
public static void main(String[] args) throws Exception {
String url = "https://jsonplaceholder.typicode.com/posts";
String jsonBody = "{\"title\":\"foo\",\"body\":\"bar\",\"userId\":1}";
HttpClient client = HttpClient.newBuilder()
.version(HttpClient.Version.HTTP_2)
.connectTimeout(Duration.ofSeconds(10))
.build();
// 1. 创建 HttpRequest,POST 方式和请求体
HttpRequest request = HttpRequest.newBuilder()
.POST(HttpRequest.BodyPublishers.ofString(jsonBody))
.uri(URI.create(url))
.header("Content-Type", "application/json")
.header("Accept", "application/json")
.build();
// 2. 发送请求并获取响应
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
// 3. 处理响应
System.out.println("Status Code: " + response.statusCode());
System.out.println("Response Body: " + response.body());
}
}
异步请求示例 (Java HttpClient 的亮点)
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.util.concurrent.CompletableFuture;
public class JavaHttpClientAsyncExample {
public static void main(String[] args) throws Exception {
String url = "https://jsonplaceholder.typicode.com/posts/1";
HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create(url))
.build();
// 发送异步请求
CompletableFuture<HttpResponse<String>> responseFuture = client.sendAsync(
request,
HttpResponse.BodyHandlers.ofString()
);
// 定义响应处理逻辑
responseFuture.thenAccept(response -> {
System.out.println("Async Status Code: " + response.statusCode());
System.out.println("Async Response Body: " + response.body());
});
System.out.println("Request sent asynchronously. Main thread continues...");
// 等待异步任务完成,否则程序会立即退出
// 在实际应用中,你不需要这样做,主线程可能会做其他事情
// 或者你的应用会一直运行
responseFuture.join();
}
}
总结与对比
| 特性 | HttpURLConnection |
Apache HttpClient | java.net.http.HttpClient |
|---|---|---|---|
| 来源 | JDK 内置 | 第三方库 (Apache) | JDK 11+ 内置 |
| 易用性 | 低,API 繁琐 | 高,API 友好 | 高,API 现代流畅 |
| 功能 | 基础 | 强大,功能全面 | 强大,支持同步/异步 |
| 异步支持 | 差 | 好 (通过 Future) | 优秀 (通过 CompletableFuture) |
| 依赖 | 无 | 需要 Maven/Gradle 依赖 | 无 (JDK 11+) |
| 推荐场景 | 简单脚本、无法添加依赖的旧项目 | 需要高级功能、连接池、重试机制的复杂项目 | 新项目首选,特别是 Java 11+ 环境 |
如何选择?
- 如果你正在开发一个新项目,并且使用的是 Java 11 或更高版本:强烈推荐使用
java.net.http.HttpClient,它是未来的方向,API 设计优秀,功能强大。 - 如果你在一个旧项目中,或者项目环境无法升级到 Java 11:使用 Apache HttpClient 是一个非常可靠和强大的选择。
- 如果你只是想写一个非常简单的、一次性的脚本,不想引入任何外部依赖:可以使用
HttpURLConnection,但请准备好处理一些繁琐的代码。

