java中调用uri请求的几种常见的方法

我们主要讲最常见的两种方法：Java原生自带的 和 第三方好用的库。

第一部分：Java 自带的"工具包"（java.net包）

Java自己就提供了一些基础的通信工具，就像家里自带的基本工具箱。

方法1：HttpURLConnection (最经典的基础方法)

步骤：

1. 找到对方的地址（创建URL对象）。

2. 打开一个连接通道（打开HttpURLConnection）。

3. 设置这次沟通的规则（设置请求方法：GET、POST等）。

4. 准备听对方回复（获取响应代码和输入流）。

5. 读取对方说的话（读取输入流，得到数据）。

6. 最后收拾干净（关闭连接）。

举个例子（GET请求）：

import java.io.BufferedReader;
import java.io.InputStreamReader;
import java.net.HttpURLConnection;
import java.net.URL;

public class BasicHttpExample {
    public static void main(String[] args) {
        try {
            // 1. 确定服务员地址（API地址）
            String urlString = "https://api.example.com/data";
            URL url = new URL(urlString);
            
            // 2. 打开连接通道
            HttpURLConnection connection = (HttpURLConnection) url.openConnection();
            
            // 3. 设置沟通规则：这次我们去"获取"信息（GET）
            connection.setRequestMethod("GET");
            
            // 4. 看看服务员反应如何（HTTP状态码 200表示成功）
            int responseCode = connection.getResponseCode();
            System.out.println("响应代码: " + responseCode);
            
            if (responseCode == HttpURLConnection.HTTP_OK) { // 200
                // 5. 读取服务员返回的话（数据）
                BufferedReader in = new BufferedReader(new InputStreamReader(connection.getInputStream()));
                String inputLine;
                StringBuilder content = new StringBuilder();
                while ((inputLine = in.readLine()) != null) {
                    content.append(inputLine);
                }
                // 6. 把读到的话打印出来
                System.out.println("响应内容: " + content.toString());
                
                // 7. 收拾干净
                in.close();
            }
            // 8. 断开连接
            connection.disconnect();
            
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

优点 ：Java自带，无需额外下载。
缺点：代码比较冗长，手动处理的东西多（比如拼接复杂的POST参数），不够现代和优雅。

---

第二部分：使用好用的"第三方工具"

因为原生的工具用起来有点麻烦，所以社区创造了更好用的库。

方法2：Apache HttpClient (一个非常流行和强大的库)

如何使用：

1. 首先，你需要把这个"工具套装"添加到你的项目中。

   • 使用Maven，在pom.xml里添加依赖

2. 使用它的API来发送请求。

举个例子（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 ApacheHttpClientExample {
    public static void main(String[] args) {
        // 1. 创建一辆智能快递车（HttpClient实例）
        try (CloseableHttpClient httpClient = HttpClients.createDefault()) {
            // 2. 写明送货地址（创建HttpGet请求）
            HttpGet request = new HttpGet("https://api.example.com/data");
            
            // 3. 发送请求，并拿到回执（执行请求，获取响应）
            try (CloseableHttpResponse response = httpClient.execute(request)) {
                // 4. 检查回执状态（状态码）
                System.out.println("响应代码: " + response.getStatusLine().getStatusCode());
                // 5. 从回执里拿出包裹内容（响应实体）
                String responseBody = EntityUtils.toString(response.getEntity());
                System.out.println("响应内容: " + responseBody);
            }
        } catch (Exception e) {
            e.printStackTrace();
        }
        // 注意：这里用了try-with-resources语法，会自动关闭车和回执，不用手动disconnect。
    }
}

优点 ：功能强大，支持HTTPS、连接池、Cookie管理等高级特性，API比原生友好。

---

方法3：OkHttp (一个更现代、高效的库)

在Android和现代Java应用中非常流行。

如何使用：

同样需要先添加依赖到项目。

举个例子（GET请求）：

import okhttp3.OkHttpClient;
import okhttp3.Request;
import okhttp3.Response;

public class OkHttpExample {
    public static void main(String[] args) {
        // 1. 创建一辆跑车（OkHttpClient实例）
        OkHttpClient client = new OkHttpClient();
        
        // 2. 构建一个送货请求单（Request）
        Request request = new Request.Builder()
                .url("https://api.example.com/data")
                .build();
        
        // 3. 用跑车发出请求单，并拿到回执（Response）
        try (Response response = client.newCall(request).execute()) {
            // 4. 检查回执状态和内容
            System.out.println("响应代码: " + response.code());
            if (response.body() != null) {
                String responseBody = response.body().string();
                System.out.println("响应内容: " + responseBody);
            }
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

优点：API设计非常简洁优雅，默认支持HTTP/2，性能好，是现代Java/Kotlin开发的首选之一。

第三部分：Spring框架的"快捷方式"（RestTemplate 和 WebClient）

方法4：RestTemplate (Spring的同步传送门)

Spring家族的老牌成员。你告诉它地址，它直接帮你把远处的数据"拿"回来，甚至能自动转换成Java对象。

// 需要在Spring项目环境中
import org.springframework.web.client.RestTemplate;

public class SpringRestTemplateExample {
    public static void main(String[] args) {
        RestTemplate restTemplate = new RestTemplate();
        String url = "https://api.example.com/data";
        // 发送GET请求，并将响应直接转换为String类
        String result = restTemplate.getForObject(url, String.class);
        System.out.println(result);
    }
}

特点 ：超级简单，但它是同步的（发请求后必须等回复，期间线程会阻塞）。

方法5：WebClient (Spring的异步、响应式传送门)

Spring家族的新星，支持非阻塞的异步请求，性能更高，适合处理大量并发请求。

// 需要在Spring WebFlux项目环境中
import org.springframework.web.reactive.function.client.WebClient;

public class SpringWebClientExample {
    public static void main(String[] args) {
        WebClient client = WebClient.create();
        client.get()
                .uri("https://api.example.com/data")
                .retrieve()
                .bodyToMono(String.class) // 这里返回的是"承诺"，而不是立即得到结果
                .subscribe(result -> System.out.println(result)); // 结果未来好了，会在这里打印
        // 主线程不会阻塞，可以继续做别的事情
        System.out.println("请求已发出，我在做别的事...");
    }
}

总结与建议

方法	适合场景	难度	备注
HttpURLConnection	学习原理、简单小工具、环境受限（不能加库）	中等	初学者建议从这里开始理解概念
Apache HttpClient	传统企业项目，需要丰富功能和稳定支持	中等	功能全，但API稍旧
OkHttp	现代Java/Android应用，追求简洁和性能	容易	对于新项目，这是非常推荐的选择
RestTemplate	传统的Spring Boot项目，简单同步调用	非常容易	Spring生态，已进入维护模式
WebClient	响应式、高并发的Spring项目	中等	Spring未来的方向，支持异步