HttpURLConnection 请求头添加指南：全面解决写入数据后请求头失效问题

HttpURLConnection：请求头添加指南

引子

使用 HttpURLConnection 发出请求时，我们经常需要添加自定义请求头信息。然而，在某些情况下，setRequestProperty() 方法似乎不起作用，服务器端并未收到带有指定请求头的请求。

问题根源

这种情况的根源在于我们在设置请求头之前向连接中写入了数据。HttpURLConnection 是一个流式 API，一旦写入数据，请求头就无法再被修改。

解决方案

要解决此问题，我们必须在向连接写入任何数据之前设置请求头。以下代码示例展示了正确的流程：

HttpURLConnection hc;
try {
    String authorization = "";
    URL address = new URL(url);
    hc = (HttpURLConnection) address.openConnection();

    // 在写入数据之前设置请求头
    if (authorization != null) {
        byte[] encodedBytes;
        encodedBytes = Base64.encode(authorization.getBytes(), 0);
        authorization = "Basic " + encodedBytes;
        hc.setRequestProperty("Authorization", authorization);
    }

    hc.setDoOutput(true);
    hc.setDoInput(true);
    hc.setUseCaches(false);
}

通过在 setDoOutput() 和 setDoInput() 调用之前调用 setRequestProperty() 方法，我们确保在写入任何数据之前设置请求头。

提示

• 要设置多个请求头，请为每个请求头单独调用 setRequestProperty() 方法。
• HttpURLConnection 还提供了 setRequestHeaders() 方法，它允许一次性设置多个请求头。
• 请注意，某些 HTTP 方法（例如 GET）不支持请求头。

常见的误解

1. 写入数据后可以添加请求头： 这是错误的。写入数据后，请求头无法再被修改。
2. 设置请求头仅在某些 HTTP 方法中起作用： 大多数 HTTP 方法都支持请求头，但某些方法（例如 GET）除外。
3. 所有请求头都受服务器端支持： 某些自定义请求头可能不受服务器端支持。
4. 请求头可以包含任何数据： 请求头必须遵循特定的语法规则，否则可能导致错误。
5. 设置请求头后，请求会自动发送： 请求头仅用于设置请求，请求的实际发送需要通过 connect() 方法或 getResponseCode() 方法等显式操作。

结论

通过遵循这些准则，我们能够有效地向 HttpURLConnection 请求添加自定义请求头，从而增强我们与服务器交互的能力。

常见问题解答

1. 为什么在写入数据后尝试添加请求头会导致错误？
   • 因为 HttpURLConnection 是一个流式 API，一旦写入数据，请求头就无法再被修改。
2. 如何在 setRequestProperty() 中设置多个请求头？
   • 为每个请求头单独调用 setRequestProperty() 方法。
3. 如何使用 setRequestHeaders() 设置多个请求头？
   • 将包含请求头键值对的 Map 对象传递给 setRequestHeaders() 方法。
4. 有哪些类型的请求头？
   • 有许多类型的请求头，包括通用请求头、实体请求头、安全请求头和缓存控制请求头。
5. 如何查看服务器端收到的请求头？
   • 这取决于服务器端，但通常可以使用日志记录或调试工具查看请求头。