### Django 中 `StreamingHttpResponse` 的参数说明及使用方法 #### 参数说明 `StreamingHttpResponse` 主要用于处理大文件传输或实时数据流场景。其构造函数接受两个主要参数： - **streaming_content**: 可迭代对象，通常是一个生成器，用来逐块提供响应内容[^1]。 - **content_type**: 字符串，默认为 `'text/html'`，指定返回的内容类型。 此外，还可以设置其他 HTTP 头部信息作为关键字参数传递给该类实例化时使用。 #### 使用方法示例 下面通过几个具体例子来展示如何正确地应用 `StreamingHttpResponse`: ##### 文件下载服务 当需要向用户提供文件下载功能而不占用过多内存资源时，可以选择这种方式读取并发送文件内容： ```python from django.http import StreamingHttpResponse import os def download_file(request, path): def file_iterator(file_name, chunk_size=8192): with open(file_name, 'rb') as f: while True: c = f.read(chunk_size) if not c: break yield c response = StreamingHttpResponse( file_iterator(path), content_type='application/octet-stream' ) # 设置附件头以便浏览器识别为下载链接 response['Content-Disposition'] = f'attachment; filename="{os.path.basename(path)}"' return response ``` 此代码片段展示了如何利用 Python 的上下文管理器 (`with`) 和生成表达式高效地分批加载大型二进制文件，并将其作为 HTTP 流形式推送给客户端设备[^4]。 ##### 实时日志查看工具 对于某些应用场景而言，可能希望构建一个能够持续推送更新消息的服务接口；这时就可以考虑采用基于事件驱动模型的设计思路配合 WebSockets 或 Server-Sent Events (SSE) 技术实现前端页面自动刷新效果： ```python from django.http import StreamingHttpResponse import time class LogStreamer(object): def __iter__(self): for i in range(5): # 模拟五次记录输出操作 message = f"[{time.strftime('%Y-%m-%d %H:%M:%S')}]: This is log entry #{i}\n" yield message.encode('utf-8') time.sleep(1) def stream_logs(request): return StreamingHttpResponse(LogStreamer(), content_type="text/event-stream") ``` 上述案例中定义了一个简单的日志生产者类 `LogStreamer`, 它实现了可迭代协议从而可以直接被当作 `streaming_content` 来源供 `StreamingHttpResponse` 对象消费[^5].