在进行web服务开发时，正确构造http请求是基础且关键的一步。开发者常遇到的一个困惑是，如何区分和正确使用http请求中的“查询参数”（query parameters）与“请求头”（headers）。错误的参数传递方式会导致服务器无法正确解析请求，进而返回错误响应，例如常见的“400 bad request”错误。
理解HTTP请求的基本结构
一个典型的HTTP请求由以下几个主要部分组成：
- 请求行 (Request Line)：包含请求方法（如GET、POST）、请求URI（Uniform Resource Identifier）和HTTP协议版本。
- 请求头 (Headers)：提供关于请求或响应的元数据，如主机名、认证信息、内容类型等。
- 空行 (Blank Line)：用于分隔请求头和请求体。
- 请求体 (Body)：包含客户端发送给服务器的数据，主要用于POST、PUT等请求方法。
查询参数与请求头的核心区别
-
查询参数 (Query Parameters)：
- 用于在GET请求中向服务器传递额外的数据，以过滤、排序或标识特定的资源。
- 它们是URI的一部分，通过问号（?）开始，并以“键=值”对的形式出现，多个参数之间用“与号”（&）连接。
- 示例：/resource?param1=value1¶m2=value2
-
请求头 (Headers)：
- 用于传递与请求本身相关的元数据，而不是请求的资源内容。
- 它们以“键: 值”对的形式出现在请求行之后、空行之前。
- 示例：Host: example.com, Authorization: Bearer
, Content-Type: application/json
问题分析：错误的参数传递方式
在原始代码中，尝试通过请求头的方式传递城市信息q: London，这与HTTP协议中查询参数的约定相悖。API服务器期望q作为一个查询参数出现在URI中，而不是作为一个独立的请求头。当服务器收到Key:
API密钥Key:
正确传递查询参数：URI中的问号语法
要正确传递查询参数，应将其附加到URI路径之后，使用问号?作为起始符。
import java.io.*;
import java.util.*;
import javax.net.ssl.SSLSocket;
import javax.net.ssl.SSLSocketFactory;
public class WeatherService {
public static void main(String[] args) throws IOException {
Properties mavenProperties = new Properties();
// 确保maven.properties文件在类路径中
InputStream propertiesStream = WeatherService.class.getResourceAsStream("/maven.properties");
if (propertiesStream == null) {
System.err.println("Error: maven.properties not found. Please ensure it's in the classpath.");
return;
}
mavenProperties.load(propertiesStream);
final String API_KEY = mavenProperties.getProperty("api.key");
if (API_KEY == null || API_KEY.isEmpty()) {
System.err.println("Error: 'api.key' not found in maven.properties.");
return;
}
SSLSocketFactory factory = (SSLSocketFactory) SSLSocketFactory.getDefault();
try (SSLSocket socket = (SSLSocket)factory.createSocket("api.weatherapi.com", 443)) {
socket.startHandshake();
Writer w = new OutputStreamWriter(socket.getOutputStream());
// 修正：将查询参数 'q=London' 附加到URI中
w.write("GET /v1/current.json?q=London HTTP/1.1\r\n");
w.write("Host: api.weatherapi.com\r\n");
// API密钥作为请求头传递，如果API文档要求如此
w.write("Key: " + API_KEY + "\r\n");
// 注意：这里不需要 'q: London\r\n'，因为它已作为URI的一部分
w.write("\r\n"); // 请求头与请求体之间的空行
w.flush();
InputStream in = socket.getInputStream();
int b;
while ((b = in.read()) != -1)
System.out.write(b);
} catch (IOException e) {
System.err.println("An error occurred during socket communication: " + e.getMessage());
e.printStackTrace();
}
}
}在上述修正后的代码中，关键的改变在于请求行： w.write("GET /v1/current.json?q=London HTTP/1.1\r\n");
这里，?q=London被正确地作为URI的查询部分发送。服务器在解析URI时，能够识别出q是一个名为q的查询参数，其值为London。
注意事项与最佳实践
-
URL编码 (URL Encoding)： 当查询参数的值包含特殊字符（如空格、&、?等）时，必须进行URL编码，以确保URI的有效性。例如，如果城市名为“New York”，则应编码为New%20York。在Java中，可以使用URLEncoder.encode()方法。
String city = "New York"; String encodedCity = URLEncoder.encode(city, StandardCharsets.UTF_8.toString()); w.write("GET /v1/current.json?q=" + encodedCity + " HTTP/1.1\r\n"); -
HTTP客户端库的使用： 直接使用SSLSocket进行HTTP通信是低层级的操作，容易出错且代码量大。在实际开发中，强烈推荐使用更高级的HTTP客户端库，如Java 11+的java.net.http.HttpClient、Apache HttpClient或Spring RestTemplate (或 WebClient)。这些库提供了更简洁、健壮的API来处理HTTP请求，包括自动处理连接管理、重试、URL编码、请求头设置等。
以下是使用java.net.http.HttpClient的示例：
import java.io.IOException; import java.net.URI; import java.net.http.HttpClient; import java.net.http.HttpRequest; import java.net.http.HttpResponse; import java.net.URLEncoder; import java.nio.charset.StandardCharsets; import java.util.Properties; import java.io.InputStream; public class WeatherServiceHttpClient { public static void main(String[] args) throws IOException, InterruptedException { Properties mavenProperties = new Properties(); try (InputStream propertiesStream = WeatherServiceHttpClient.class.getResourceAsStream("/maven.properties")) { if (propertiesStream == null) { System.err.println("Error: maven.properties not found."); return; } mavenProperties.load(propertiesStream); } final String API_KEY = mavenProperties.getProperty("api.key"); if (API_KEY == null || API_KEY.isEmpty()) { System.err.println("Error: 'api.key' not found."); return; } String city = "London"; String encodedCity = URLEncoder.encode(city, StandardCharsets.UTF_8.toString()); HttpClient client = HttpClient.newHttpClient(); HttpRequest request = HttpRequest.newBuilder() .uri(URI.create("https://api.weatherapi.com/v1/current.json?q=" + encodedCity)) .header("Key", API_KEY) // API密钥作为请求头 .GET() .build(); HttpResponseresponse = client.send(request, HttpResponse.BodyHandlers.ofString()); System.out.println("Status Code: " + response.statusCode()); System.out.println("Response Body:\n" + response.body()); } } 使用高级客户端库不仅简化了代码，也提高了可读性和可维护性。
API文档查阅： 始终查阅目标API的官方文档，了解其对参数传递、认证方式（API密钥、OAuth等）和响应格式的具体要求。这是避免错误最直接有效的方法。
总结
正确区分和使用HTTP请求中的查询参数与请求头是构建可靠Web客户端应用程序的关键。查询参数通过URI的问号?语法传递，用于指定资源或过滤数据；而请求头则用于传递请求的元数据，如认证信息、主机名等。在Java中，虽然可以直接操作SSLSocket，但为了提高开发效率和代码健壮性，强烈建议使用java.net.http.HttpClient等高级HTTP客户端库。遵循HTTP规范和API文档要求，将确保您的应用程序能够与Web服务进行高效且无误的通信。
