Java中URLConnection发送请求方法详解

在Java中发送网络请求，`URLConnection`作为基础选择，犹如标准库提供的瑞士军刀，虽不花哨，却能直接与HTTP/HTTPS协议交互。本文旨在介绍如何利用`URLConnection`发送GET、POST请求，设置请求头，并处理响应，虽过程略显繁琐，但有助于理解网络通信本质。核心流程包括创建URL对象、打开连接、设置请求方法及属性、发送数据（POST请求时）、读取响应和关闭资源。针对GET请求，需设置请求方法，配置请求头、超时时间，并读取响应流；POST请求则需设置`setDoOutput(true)`并写入请求体。此外，本文还将探讨如何处理超时、重定向和SSL证书等常见问题，以及通过连接复用和资源管理优化性能。最后，对比`URLConnection`与HttpClient、OkHttp等现代库，帮助开发者根据项目需求选择合适的网络请求方案。

在Java中发送网络请求的解决方案是使用URLConnection，其核心流程包括：1. 创建URL对象；2. 打开连接；3. 设置请求方法和属性；4. 发送数据（POST请求）；5. 读取响应；6. 关闭资源。对于GET请求，需设置请求方法为GET，配置请求头、超时时间，并读取响应流；对于POST请求，还需设置setDoOutput(true)，写入请求体。此外，处理常见问题如超时需设置连接和读取超时时间；处理重定向可启用或禁用自动跟随，并注意次数限制；HTTPS请求中如遇SSL证书问题，开发环境可临时禁用验证（不推荐用于生产）。性能优化方面，应启用连接复用以减少TCP连接开销，并通过try-with-resources确保流的及时关闭，避免资源泄漏。选择网络请求库时，若需轻量级或学习用途，可使用URLConnection；若项目运行在Java 11+，推荐使用内置的HttpClient；若需功能强大且稳定，可选用Apache HttpClient；若追求高性能和易用性，尤其在Android开发中，推荐OkHttp。

在Java中发送网络请求，URLConnection是一个非常基础且内置的选择。它就像是Java标准库提供的一把瑞士军刀，虽然不是最花哨的，但在需要直接与HTTP/HTTPS协议交互时，它能完成任务。你可以用它来发送GET、POST请求，设置请求头，处理响应，虽然过程可能比现代HTTP客户端库稍微繁琐一些，但它提供了对底层通信的直接控制，对于理解网络通信的本质非常有帮助。

解决方案

使用URLConnection发送网络请求，核心流程包括创建URL对象、打开连接、设置请求方法和属性、发送数据（POST请求）、读取响应以及关闭资源。

一个简单的GET请求示例如下：

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

public class UrlConnectionGetExample {

    public static void main(String[] args) {
        try {
            URL url = new URL("https://jsonplaceholder.typicode.com/posts/1"); // 示例URL
            HttpURLConnection connection = (null); // 类型转换是必要的
            connection.setRequestMethod("GET"); // 设置请求方法为GET
            connection.setRequestProperty("User-Agent", "Mozilla/5.0"); // 模拟浏览器User-Agent

            // 设置连接和读取超时，避免长时间等待
            connection.setConnectTimeout(5000); // 5秒连接超时
            connection.setReadTimeout(8000); // 8秒读取超时

            int responseCode = connection.getResponseCode();
            System.out.println("GET Response Code :: " + responseCode);

            if (responseCode == HttpURLConnection.HTTP_OK) { // 检查HTTP响应码
                BufferedReader in = new BufferedReader(new InputStreamReader(connection.getInputStream()));
                String inputLine;
                StringBuffer response = new StringBuffer();

                while ((inputLine = in.readLine()) != null) {
                    response.append(inputLine);
                }
                in.close(); // 确保流被关闭

                System.out.println(response.toString());
            } else {
                System.out.println("GET request not worked");
            }

        } catch (Exception e) {
            e.printStackTrace();
        } finally {
            // 在实际应用中，这里应该确保connection被断开，虽然通常JVM会处理
            // connection.disconnect(); // 显式断开连接，释放资源
        }
    }
}

对于POST请求，你需要设置setDoOutput(true)并写入请求体：

import java.io.BufferedReader;
import java.io.DataOutputStream;
import java.io.InputStreamReader;
import java.net.HttpURLConnection;
import java.net.URL;
import java.nio.charset.StandardCharsets;

public class UrlConnectionPostExample {

    public static void main(String[] args) {
        try {
            URL url = new URL("https://jsonplaceholder.typicode.com/posts"); // 示例POST URL
            HttpURLConnection connection = (HttpURLConnection) url.openConnection();
            connection.setRequestMethod("POST");
            connection.setRequestProperty("User-Agent", "Mozilla/5.0");
            connection.setRequestProperty("Content-Type", "application/json"); // 假设发送JSON数据
            connection.setDoOutput(true); // 允许写入请求体

            String jsonInputString = "{\"title\": \"foo\", \"body\": \"bar\", \"userId\": 1}";
            byte[] postData = jsonInputString.getBytes(StandardCharsets.UTF_8);

            try (DataOutputStream wr = new DataOutputStream(connection.getOutputStream())) {
                wr.write(postData);
                wr.flush();
            } // try-with-resources 会自动关闭流

            int responseCode = connection.getResponseCode();
            System.out.println("POST Response Code :: " + responseCode);

            if (responseCode == HttpURLConnection.HTTP_CREATED || responseCode == HttpURLConnection.HTTP_OK) {
                BufferedReader in = new BufferedReader(new InputStreamReader(connection.getInputStream()));
                String inputLine;
                StringBuffer response = new StringBuffer();

                while ((inputLine = in.readLine()) != null) {
                    response.append(inputLine);
                }
                in.close();
                System.out.println(response.toString());
            } else {
                System.out.println("POST request not worked, Response Code: " + responseCode);
            }

        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

URLConnection与HttpClient、OkHttp等现代库有何不同？我应该选择哪种方式？

谈到Java的网络请求，URLConnection确实是老前辈了。它内置在JDK里，你不需要引入任何额外的依赖就能用。这在一些非常轻量级的应用或者你对依赖有严格控制的场景下，是个不错的优势。然而，它也因此显得有些“简陋”，很多现代HTTP客户端库提供的便利功能，比如连接池管理、请求重试、更友好的API链式调用、拦截器等等，URLConnection都需要你手动去实现，或者至少是更复杂的配置。我个人觉得，它就像是给你提供了原始的砖块和水泥，你可以盖房子，但得一砖一瓦地来。

相比之下，像Apache HttpClient、Square的OkHttp，以及Java 11以后内置的java.net.http.HttpClient，它们都提供了更高级别的抽象和更丰富的功能。

• Apache HttpClient：这是一个非常成熟且功能强大的库，在很长一段时间内都是Java领域事实上的HTTP客户端标准。它处理了连接池、认证、重定向、请求重试等许多复杂细节，API也比URLConnection友好得多。
• OkHttp：这是我个人非常喜欢的一个库，尤其是在Android开发中。它设计精良，性能卓越，支持HTTP/2和WebSocket，内置连接池，并且提供了拦截器机制，可以方便地进行日志记录、认证等操作。它的API设计非常流畅，用起来很舒服。
• Java 11+ java.net.http.HttpClient：这是JDK官方出品的现代HTTP客户端。它支持HTTP/2、异步请求，并提供了Builder模式来构建请求，API设计上吸收了现代库的优点，用起来非常现代化。如果你的项目运行在Java 11或更高版本上，这通常是首选，因为它无需额外依赖，且功能强大。

如何选择？

我的建议是：

1. 如果你只是做最简单的GET请求，或者需要对底层协议有极致的控制，并且不想引入任何第三方依赖，那么URLConnection可以胜任。但要做好心理准备，一旦需求复杂起来，你会发现自己写了大量的样板代码。
2. 如果你的项目运行在Java 11或更高版本，并且追求现代、异步、高性能的解决方案，强烈推荐使用java.net.http.HttpClient。它是未来的方向。
3. 如果你的项目还在Java 8，并且需要一个功能强大、成熟稳定的HTTP客户端，Apache HttpClient依然是可靠的选择。
4. 如果你对性能、易用性有较高要求，或者在Android开发中，OkHttp是极佳的选择。它在很多方面甚至比Java 11的内置客户端更灵活和强大。

总的来说，对于大多数生产环境的应用，我更倾向于使用OkHttp或Java 11+的内置HttpClient，它们能让你更专注于业务逻辑，而不是网络通信的底层细节。URLConnection更多的是作为一种学习和理解Java网络通信基础的工具。

处理URLConnection中的常见问题与错误：超时、重定向与SSL证书

在使用URLConnection时，你很快就会遇到一些实际问题，比如请求挂起、重定向处理不当或者HTTPS连接失败。这些都是网络编程中绕不开的坎，URLConnection虽然提供了处理的机制，但往往需要你手动去配置和处理。

1. 超时 (Timeouts)

网络请求最怕的就是“没反应”，要么是连不上，要么是连上了但数据迟迟不来。URLConnection提供了两个关键的超时设置：

• connection.setConnectTimeout(int timeoutMillis)：这个设置的是建立连接的超时时间。如果在这个时间内无法与服务器建立TCP连接，就会抛出SocketTimeoutException。
• connection.setReadTimeout(int timeoutMillis)：这个设置的是从连接中读取数据的超时时间。一旦连接建立，如果在这个时间内没有新的数据流过来，也会抛出SocketTimeoutException。

我的经验是，这两个超时值一定要设置，而且要根据你的应用场景和网络环境合理调整。不然，你的程序可能会因为一个无法响应的外部服务而无限期地挂起，消耗宝贵的线程资源。

2. 重定向 (Redirects)

HTTP协议中有3xx状态码表示重定向，比如301（永久移动）或302（临时移动）。HttpURLConnection默认是会自动跟随重定向的。这意味着如果服务器返回一个302，它会自动发起一个新的请求到Location头指定的URL。这通常很方便，但有时候你可能需要：

• 禁用自动重定向：connection.setInstanceFollowRedirects(false); 这样你就可以手动检查响应码是否是3xx，然后从Location头中获取新的URL，自己决定是否发起新的请求。这在需要分析重定向链或者处理特定认证流程时很有用。
• 处理重定向次数限制：虽然HttpURLConnection默认会跟随，但它内部也有一个最大重定向次数的限制，以防止无限重定向循环。如果你遇到重定向次数过多导致的异常，可能需要检查服务器端的重定向逻辑。

3. SSL证书 (SSL/TLS Certificates)

当你使用HTTPS连接时，URLConnection会验证服务器的SSL证书。这是为了确保你连接的是预期的服务器，并且通信是加密的。如果证书有问题，比如：

• 自签名证书：服务器使用了内部颁发的、不被公共CA信任的证书。
• 证书过期或域名不匹配：证书的有效期过了，或者证书颁发给的域名与你访问的域名不符。

这时，你会遇到javax.net.ssl.SSLHandshakeException或类似的异常。在生产环境中，正确的做法是确保服务器使用由受信任CA颁发的有效证书。但在开发或测试环境中，有时为了方便，可能会暂时禁用证书验证。请注意，以下操作仅用于测试，切勿在生产环境中使用，因为它会严重降低安全性！

你可以通过设置自定义的TrustManager和HostnameVerifier来绕过证书验证。这涉及到一些底层的SSLContext配置，比如：

// 仅用于测试！严重不推荐在生产环境中使用！
public static void disableSslVerification() {
    try {
        // 创建一个不验证任何证书的TrustManager
        TrustManager[] trustAllCerts = new TrustManager[]{
            new X509TrustManager() {
                public X509Certificate[] getAcceptedIssuers() {
                    return null;
                }
                public void checkClientTrusted(X509Certificate[] certs, String authType) {
                }
                public void checkServerTrusted(X509Certificate[] certs, String authType) {
                }
            }
        };

        // 获取SSLContext实例
        SSLContext sc = SSLContext.getInstance("TLS");
        sc.init(null, trustAllCerts, new java.security.SecureRandom());
        HttpsURLConnection.setDefaultSSLContext(sc);

        // 创建一个不验证任何主机名的HostnameVerifier
        HostnameVerifier allHostsValid = new HostnameVerifier() {
            public boolean verify(String hostname, SSLSession session) {
                return true;
            }
        };
        HttpsURLConnection.setDefaultHostnameVerifier(allHostsValid);
    } catch (Exception e) {
        e.printStackTrace();
    }
}

然后在你的代码中调用disableSslVerification()。再次强调，这是非常危险的做法，因为它让你的应用容易受到中间人攻击。正确的处理方式是导入自签名证书到Java的信任库，或者使用有效的公共证书。

优化URLConnection性能与资源管理：连接复用与流关闭

虽然URLConnection在功能上相对基础，但合理地使用它，也能在性能和资源管理上做到不拖后腿。这两个方面，连接复用和资源流的正确关闭，是我在实际项目中踩过坑、也因此学到教训的地方。

1. 连接复用 (Connection Reuse / Keep-Alive)

HTTP/1.1协议引入了“Keep-Alive”机制，允许客户端和服务器在一次TCP连接上发送和接收多个HTTP请求/响应。这显著减少了每次请求都建立和关闭TCP连接的开销，尤其是在短时间内对同一服务器进行多次请求时，效果非常明显。

HttpURLConnection默认是支持HTTP Keep-Alive的，只要服务器也支持并返回相应的Connection: Keep-Alive头部。这意味着如果你连续向同一个域名发起请求，HttpURLConnection会尝试复用底层的TCP连接。

• 系统属性控制：你可以通过设置Java的系统属性来微调这个行为，尽管通常不需要。
  • System.setProperty("http.keepAlive", "true"); (默认就是true)
  • System.setProperty("http.maxConnections", "5"); (默认是5，表示每个目标主机最多可以复用5个持久连接) 如果你发现连接复用不理想，可以检查服务器是否发送了Connection: close头，或者是否配置了过短的Keep-Alive超时。

在实际应用中，如果你的服务需要高并发地访问某个外部API，而你又坚持使用URLConnection，那么确保连接复用正常工作至关重要。否则，大量的TCP连接建立和关闭会成为性能瓶颈，甚至可能耗尽操作系统的文件句柄资源。

2. 资源管理 (Stream Closure)

这是最容易被忽视，但也是最致命的问题之一。在Java中，任何打开的I/O流（InputStream、OutputStream、Reader、Writer等）都必须被显式地关闭。如果你不关闭它们，它们会一直占用系统资源（比如文件句柄、网络套接字），最终导致资源耗尽，抛出Too many open files之类的错误，让你的服务崩溃。

对于URLConnection，你需要确保：

• 输入流和输出流的关闭：无论请求成功还是失败，从connection.getInputStream()和connection.getOutputStream()获取到的流都必须被关闭。
• HttpURLConnection的disconnect()方法：虽然不是强制的，但调用connection.disconnect()是一个好习惯。它会释放该连接占用的所有资源，包括底层的套接字。特别是在你确定不再使用这个连接实例时，调用它能更快地释放资源。

最佳实践：使用Java 7引入的try-with-resources语句。它能确保在try块结束后，所有实现了AutoCloseable接口的资源都会被自动关闭，即使发生异常也不例外。这大大简化了资源管理的代码，也减少了出错的可能性。

// 示例：使用try-with-resources确保流关闭
try {
    URL url = new URL("http://example.com");
    HttpURLConnection connection = (HttpURLConnection) url.openConnection();
    // ... 设置请求方法、属性等

    int responseCode = connection.getResponseCode();
    if (responseCode == HttpURLConnection.HTTP_OK) {
        try (BufferedReader in = new BufferedReader(new InputStreamReader(connection.getInputStream()))) {
            String inputLine;
            StringBuffer response = new StringBuffer();
            while ((inputLine = in.readLine()) != null) {
                response.append(inputLine);
            }
            System.out.println(response.toString());
        } // in 会在这里自动关闭
    }
    // ...
} catch (Exception e) {
    e.printStackTrace();
} finally {
    // 确保连接断开，释放资源
    if (connection != null) {
        connection.disconnect();
    }
}

我见过太多因为没有正确关闭流而导致系统崩溃的案例。这就像你打开了水龙头却忘记关，水流不止，最终会导致水箱空了或者整个房间被淹。所以，每次使用完流，务必确保它们被关闭，这是编写健壮网络应用的基础。

以上就是本文的全部内容了，是否有顺利帮助你解决问题？若是能给你带来学习上的帮助，请大家多多支持golang学习网！更多关于文章的相关知识，也可关注golang学习网公众号。