代码收藏家 Python HttpUtils工具类：高效简化HTTP请求的实用工具
在现代的 Web 开发和 API 集成中，HTTP 请求是最常见的操作之一。无论是获取数据、提交表单，还是与 RESTful API 交互，我们都需要频繁地发送 HTTP 请求。为了简化这些操作，提升代码的可读性和可维护性，我们可以使用一个高效的工具类——HttpUtils。本文将详细介绍 HttpUtils 的设计思路、功能实现以及实际应用场景，帮助你快速掌握这一工具的使用方法。
1. HttpUtils 简介
HttpUtils 是一个基于 Python requests 库封装的 HTTP 请求工具类。它提供了常用的 HTTP 请求方法（如 GET、POST、PUT、DELETE、PATCH），并支持通过统一的 send_request 方法动态发送请求。通过 HttpUtils，开发者可以更简洁、高效地处理 HTTP 请求，减少重复代码，提升开发效率。
2. 功能详解
HttpUtils 的核心功能包括：
send_request 方法动态选择请求方法。下面我们将逐一介绍这些功能，并通过示例代码展示其使用方法。
2.1 GET 请求
GET 请求用于从服务器获取资源。HttpUtils 提供了 get 方法，支持传递 URL、查询参数和请求头。
示例代码：
response = HttpUtils.get(
url="https://api.example.com/data",
params={"key": "value"},
headers={"Content-Type": "application/json"}
)
print("GET Response:", response.json())
参数说明：
url：请求的 URL。params：查询参数，字典类型。headers：请求头，字典类型。2.2 POST 请求
POST 请求用于向服务器提交数据或创建资源。HttpUtils 提供了 post 方法，支持传递 URL、请求体数据（data 或 json）和请求头。
示例代码：
response = HttpUtils.post(
url="https://api.example.com/data",
json={"ip": "117.136.12.79"},
headers={"Content-Type": "application/json", "Authorization": "Bearer your_token_here"}
)
print("POST Response:", response.json())
参数说明：
url：请求的 URL。data：表单数据，字典类型。json：JSON 格式的请求体数据，字典类型。headers：请求头，字典类型。2.3 PUT 请求
PUT 请求用于更新服务器上的资源。HttpUtils 提供了 put 方法，支持传递 URL、请求体数据和请求头。
示例代码：
response = HttpUtils.put(
url="https://api.example.com/data/1",
data={"key": "new_value"},
headers={"Content-Type": "application/json", "Authorization": "Bearer your_token_here"}
)
print("PUT Response:", response.json())
参数说明：
url：请求的 URL。data：请求体数据，字典类型。headers：请求头，字典类型。2.4 DELETE 请求
DELETE 请求用于删除服务器上的资源。HttpUtils 提供了 delete 方法，支持传递 URL 和请求头。
示例代码：
response = HttpUtils.delete(
url="https://api.example.com/data/1",
headers={"Authorization": "Bearer your_token_here"}
)
print("DELETE Response:", response.status_code)
参数说明：
url：请求的 URL。headers：请求头，字典类型。2.5 PATCH 请求
PATCH 请求用于部分更新服务器上的资源。HttpUtils 提供了 patch 方法，支持传递 URL、请求体数据和请求头。
示例代码：
response = HttpUtils.patch(
url="https://api.example.com/data/1",
data={"key": "updated_value"},
headers={"Content-Type": "application/json", "Authorization": "Bearer your_token_here"}
)
print("PATCH Response:", response.json())
参数说明：
url：请求的 URL。data：请求体数据，字典类型。headers：请求头，字典类型。2.6 动态请求方法 (send_request)
send_request 方法是一个通用的 HTTP 请求方法，支持动态选择请求方法（GET、POST、PUT、DELETE、PATCH）。通过该方法，开发者可以根据需求灵活地发送请求。
示例代码：
# 发送 GET 请求
response = HttpUtils.send_request(
method="GET",
url="https://api.example.com/data",
params={"key": "value"},
headers={"Content-Type": "application/json"}
)
print("GET Response:", response.json())
# 发送 POST 请求
response = HttpUtils.send_request(
method="POST",
url="https://api.example.com/data",
json={"ip": "117.136.12.79"},
headers={"Content-Type": "application/json", "Authorization": "Bearer your_token_here"}
)
print("POST Response:", response.json())
参数说明：
method：请求方法（‘GET’, ‘POST’, ‘PUT’, ‘DELETE’, ‘PATCH’）。url：请求的 URL。params：查询参数，字典类型（仅适用于 GET 请求）。data：请求体数据，字典类型（适用于 POST、PUT、PATCH 请求）。json：JSON 格式的请求体数据，字典类型（适用于 POST、PUT、PATCH 请求）。headers：请求头，字典类型。3. 实际应用场景
3.1 与 RESTful API 交互
HttpUtils 非常适合与 RESTful API 交互。例如，获取用户信息、创建新用户、更新用户信息、删除用户等操作都可以通过 HttpUtils 轻松实现。
3.2 数据爬取
在数据爬取场景中，HttpUtils 可以帮助你快速发送 HTTP 请求，获取网页内容或 API 数据。
3.3 自动化测试
在自动化测试中，HttpUtils 可以用于模拟客户端请求，测试服务器的响应是否符合预期。
4、代码总览
import requests as http
class HttpUtils:
"""
HTTP工具类，封装了常用的HTTP请求方法，并支持从参数发送请求。
"""
@staticmethod
def get(url, params=None, headers=None):
"""
发送GET请求。
:param url: 请求的URL
:param params: 请求参数，字典类型
:param headers: 请求头，字典类型
:return: 响应对象
"""
return http.get(url, params=params, headers=headers)
@staticmethod
def post(url, data=None, json=None, headers=None):
"""
发送POST请求。
:param url: 请求的URL
:param data: 请求体数据，字典类型
:param json: JSON格式的请求体数据，字典类型
:param headers: 请求头，字典类型
:return: 响应对象
"""
return http.post(url, data=data, json=json, headers=headers)
@staticmethod
def put(url, data=None, headers=None):
"""
发送PUT请求。
:param url: 请求的URL
:param data: 请求体数据，字典类型
:param headers: 请求头，字典类型
:return: 响应对象
"""
return http.put(url, data=data, headers=headers)
@staticmethod
def delete(url, headers=None):
"""
发送DELETE请求。
:param url: 请求的URL
:param headers: 请求头，字典类型
:return: 响应对象
"""
return http.delete(url, headers=headers)
@staticmethod
def patch(url, data=None, headers=None):
"""
发送PATCH请求。
:param url: 请求的URL
:param data: 请求体数据，字典类型
:param headers: 请求头，字典类型
:return: 响应对象
"""
return http.patch(url, data=data, headers=headers)
@staticmethod
def send_request(method, url, params=None, data=None, json=None, headers=None):
"""
根据参数发送HTTP请求。
:param method: 请求方法（'GET', 'POST', 'PUT', 'DELETE', 'PATCH'）
:param url: 请求的URL
:param params: 请求参数，字典类型（仅适用于GET请求）
:param data: 请求体数据，字典类型（适用于POST, PUT, PATCH请求）
:param json: JSON格式的请求体数据，字典类型（适用于POST, PUT, PATCH请求）
:param headers: 请求头，字典类型
:return: 响应对象
"""
method = method.upper()
if method == 'GET':
return HttpUtils.get(url, params=params, headers=headers)
elif method == 'POST':
return HttpUtils.post(url, data=data, json=json, headers=headers)
elif method == 'PUT':
return HttpUtils.put(url, data=data, headers=headers)
elif method == 'DELETE':
return HttpUtils.delete(url, headers=headers)
elif method == 'PATCH':
return HttpUtils.patch(url, data=data, headers=headers)
else:
raise ValueError(f"Unsupported HTTP method: {method}")
5、示例用法
if __name__ == "__main__":
# 示例1: 发送GET请求
response = HttpUtils.send_request(
method="GET",
url="https://api.example.com/data",
params={"key": "value"},
headers={"Content-Type": "application/json"}
)
print("GET Response:", response.json())
# 示例2: 发送POST请求
response = HttpUtils.send_request(
method="POST",
url="https://api.vore.top/api/IPdata",
json={"ip": "117.136.12.79"},
headers={"Content-Type": "application/json", "Authorization": "Bearer your_token_here"}
)
print("POST Response:", response.json())
# 示例3: 发送PUT请求
response = HttpUtils.send_request(
method="PUT",
url="https://api.example.com/data/1",
data={"key": "new_value"},
headers={"Content-Type": "application/json", "Authorization": "Bearer your_token_here"}
)
print("PUT Response:", response.json())
# 示例4: 发送DELETE请求
response = HttpUtils.send_request(
method="DELETE",
url="https://api.example.com/data/1",
headers={"Authorization": "Bearer your_token_here"}
)
print("DELETE Response:", response.status_code)
# 示例5: 发送PATCH请求
response = HttpUtils.send_request(
method="PATCH",
url="https://api.example.com/data/1",
data={"key": "updated_value"},
headers={"Content-Type": "application/json", "Authorization": "Bearer your_token_here"}
)
print("PATCH Response:", response.json())
6. 总结
HttpUtils 是一个功能强大且易于使用的 HTTP 请求工具类。通过封装常用的 HTTP 请求方法，它极大地简化了 HTTP 请求的操作，提升了代码的可读性和可维护性。无论是与 RESTful API 交互，还是进行数据爬取和自动化测试，HttpUtils 都能帮助你高效完成任务。
希望本文对你有所帮助！如果你有任何问题或建议，欢迎在评论区留言讨论。如果你觉得这篇文章对你有用，别忘了点赞和分享哦！
作者：FinkGO小码
