杰瑞科技汇

Java request 方法有哪些核心用法?

  1. 传统且强大的方式:使用 HttpURLConnection (JDK 自带) 或 Apache HttpClient (第三方库)。
  2. 现代且便捷的方式:使用 Java 11+ 引入的 java.net.http.HttpClient (JDK 自带)。

下面我将逐一介绍这些方法,并提供代码示例。

Java request 方法有哪些核心用法?-图1
(图片来源网络,侵删)

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 的设计更加面向对象,通过 HttpClientHttpRequestHttpResponse 对象来操作。

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 非常现代化。

Java request 方法有哪些核心用法?-图2
(图片来源网络,侵删)

主要特点:

  • 优点:现代化 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,但请准备好处理一些繁琐的代码。
Java request 方法有哪些核心用法?-图3
(图片来源网络,侵删)
分享:
扫描分享到社交APP
上一篇
下一篇