在 HTTP 请求中使用查询

什么是查询？

在 HTTP 请求中，查询（Query）是一种用于在 URL 中传递参数的方式。通常，查询位于 URL 的问号（?）后面，多个查询之间使用 ampersand（&）分隔。

例如，在以下 URL 中：

https://example.com/search?q=hello+world&page=2&sortby=date

查询部分是 ?q=hello+world&page=2&sortby=date，其中：

• q=hello+world 表示查询字符串为 “hello world”
• page=2 表示页码为 “2”
• sortby=date 表示按日期排序

在程序中使用查询

在 HTTP 请求中，通常将查询作为请求参数传递。对于大多数 HTTP 客户端库，可以使用字典（或映射）来表示查询参数。

以下是使用 Python requests 库发出带有查询的 HTTP GET 请求的示例：

import requests

query = {
    'q': 'hello world',
    'page': '2',
    'sortby': 'date'
}

response = requests.get('https://example.com/search', params=query)

print(response.text)

在该示例中，我们定义了一个名为 query 的字典，其中包含查询参数。然后，我们将该字典作为 params 参数传递给 requests.get 方法，以自动生成查询字符串，并将其附加到 URL 的末尾。

在查询中编码特殊字符

在查询中，某些字符（如空格、&、%）需要进行 URL 编码，以确保它们被正确传输并被正确解析。可以使用 Python 的 urllib.parse 模块来对查询字符串进行编码。

以下是一个使用 Python urllib.parse 模块对查询字符串进行编码的示例：

from urllib.parse import urlencode

query = {
    'q': 'hello world',
    'page': '2',
    'sortby': 'date'
}

encoded_query = urlencode(query)

print(encoded_query)

输出将是：

q=hello+world&page=2&sortby=date

注意，空格被编码为 +，而不是 %20。这是因为 + 是 URL 编码的一部分，将映射到空格字符，而 urlencode() 函数默认使用 +。

结论

在 HTTP 请求中，查询是一种方便的传递参数的方式。它们可以轻松地附加到 URL 中，并且大多数 HTTP 客户端库都提供了方便的方法来设置查询参数。在编写代码时，请记住对包括空格和其他特殊字符在内的查询参数进行 URL 编码。