### MultipartEncoder 的基本使用方法 `MultipartEncoder` 是 `requests_toolbelt` 库中用于处理 `multipart/form-data` 编码的核心类，常用于通过 HTTP 请求上传文件或表单数据。其构造函数接受一个名为 `fields` 的参数，该参数是一个字典，用于定义请求中的各个字段。 ```python from requests_toolbelt.multipart.encoder import MultipartEncoder import requests multipart_data = MultipartEncoder( fields={ "id": '1653302392217', "read_duration_list": '[{"id":234545878,"type":2,"duration":11,"start_time":"1653302392217","trigger_page":"PersonalPage"}]', "now": "1653302392217", "type": '1' } ) headers = { 'Content-Type': multipart_data.content_type, 'accept': 'application/json' } response = requests.post("https://api.code.com/upload", data=multipart_data, headers=headers) print(response.status_code) ``` ### 参数说明 `MultipartEncoder` 的 `fields` 参数支持多种格式的字段值： - **字符串**：直接传递字符串将作为普通文本字段。 ```python "field_name": "value" ``` - **元组**：可以包含三个元素 `(filename, file_object, content_type)` 来表示文件上传字段。 ```python "file_field": ("filename.txt", open("filename.txt", "rb"), "text/plain") ``` - **带有 `None` 的元组**：可用于指定字段值为 JSON 数据或其他非文件类型的内容。 ```python "json_field": (None, '{"key": "value"}', "application/json") ``` 此外，`MultipartEncoder` 还提供了一个 `boundary` 参数，用于自定义分隔符。默认情况下，分隔符由库自动生成，但可以通过以下方式手动设置： ```python multipart_form_data = MultipartEncoder( fields={"field": "value"}, boundary="---------------------------123" ) ``` ### 使用 MultipartEncoderMonitor 获取上传进度 如果需要监控文件上传进度，可以使用 `MultipartEncoderMonitor` 类，并传入一个回调函数来跟踪上传状态： ```python from requests_toolbelt.multipart import encoder import requests def progress_callback(monitor): progress = (monitor.bytes_read / monitor.len) * 100 print(f"\r 文件上传进度：{int(progress)}% ({monitor.bytes_read}/{monitor.len})", end="") file_name = "example.zip" file_path = f"/path/to/{file_name}" e = encoder.MultipartEncoder( fields={ 'file': (file_name, open(file_path, 'rb'), 'application/x-zip-compressed'), 'key1': 'value1', 'key2': 'value2' } ) m = encoder.MultipartEncoderMonitor(e, progress_callback) headers = { "Content-Type": m.content_type } response = requests.post("https://example.com/upload", data=m, headers=headers) print("\n 请求结果：", response.json()) ``` ### 示例：完整的文件上传请求 以下是一个更完整的示例，展示了如何结合文件上传和普通字段发送 POST 请求： ```python from requests_toolbelt.multipart.encoder import MultipartEncoder import requests # 定义字段 multipart_data = MultipartEncoder( fields={ "id": "1653302392217", "read_duration_list": '[{"id":234545878,"type":2,"duration":11,"start_time":"1653302392217","trigger_page":"PersonalPage"}]', "files": ("example.zip", open("/path/to/example.zip", "rb"), "application/x-zip-compressed") } ) # 设置请求头 headers = { "Content-Type": multipart_data.content_type, "accept": "application/json" } # 发送请求 response = requests.post("https://api.code.com/upload", data=multipart_data, headers=headers) print(response.status_code) ``` ---