Django4 中文入门教程 Django4.0 文件上传-上传 Handlers

2024-02-25 开发教程 Django4 中文入门教程 匿名 4

当一个用户上传文件时,Django 会把文件数据传递给 ​upload handler​ —— 这是一个很小的类,它用来在上传时处理文件数据。上传处理模块最初定义在 ​FILE_UPLOAD_HANDLERS ​里,默认为:

["django.core.files.uploadhandler.MemoryFileUploadHandler",
"django.core.files.uploadhandler.TemporaryFileUploadHandler"]

MemoryFileUploadHandler ​和 ​TemporaryFileUploadHandler ​提供 Django 默认文件上传行为,小文件读入内存,大文件存在磁盘上。
你可以编写自定义的 ​handlers ​来自定义 Django 如何处理文件。比如,你可以使用自定义的 ​handlers ​来强制处理用户层面的配额,动态压缩数据,渲染进度条,甚至可以将数据发送到其他存储地址而不是本地。

上传数据的存储

在保存上传的文件之前,数据需要保存到某处。
默认情况下,如果上传的文件小于2.5兆,Django 将把文件的所有内容保存到内存里。这意味着保存文件只涉及从内存中读取和写入磁盘,因此这很快。
但如果上传的文件很大,Django 会把文件写入系统临时目录的临时文件里存储。在类 Unix 平台里这意味着 Django 会生成一个类似名为 ​/tmp/tmpzfp6I6.upload​ 的文件。如果上传的文件非常大,你可以查看这个文件的大小增长,因为 Django 将数据流式传输到磁盘上。

动态修改上传处理程序

有时候某些视图需要不同的上传行为。在这些例子里,你可以基于每个请求覆盖上传处理程序。默认情况下,这个列表将包含由 ​FILE_UPLOAD_HANDLERS ​设置的上传处理程序,但你可以像修改其他列表一样修改这个列表。
比如,假设你正在编写 ​ProgressBarUploadHandler ​,来提供在上传过程中的反馈给 ​Ajax widget​。你需要添加这个处理程序到你的上传处理模块:

request.upload_handlers.insert(0, ProgressBarUploadHandler(request))

你或许想在这里使用 ​list.insert()​ (而不是 ​append()​ ),因为进度条处理程序需要在其他处理程序之前使用。记住,上传处理程序是按顺序处理的。
如果你想完全替换上传处理程序,你需要指定新列表:

request.upload_handlers = [ProgressBarUploadHandler(request)]

注解

你只能在访问 ​request.POST​ 或 ​request.FILES​ 之前修改上传处理程序,开始上传处理后修改上传处理程序没有意义。如果你从读取 ​request.POST​ 或 ​request.FILES​ 之后尝试修改 ​request.upload_handlers​ ,Django 会报错。
因此,你要尽早在视图里修改上传处理程序。
而且, ​request.POST​ 由 ​CsrfViewMiddleware ​访问,默认情况下已开启。这意味着你需要在视图上使用 ​csrf_exempt()​ 来允许你改变上传处理程序。然后你需要在实际处理请求的函数上使用 ​csrf_protect()​ 。注意这可能会让处理程序在 CSRF 检测完成之前开始接受文件上传。示例:

from django.views.decorators.csrf import csrf_exempt, csrf_protect
@csrf_exempt
def upload_file_view(request):
request.upload_handlers.insert(0, ProgressBarUploadHandler(request))
return _upload_file_view(request)
@csrf_protect
def _upload_file_view(request):
... # Process request

如果你使用的是基于类的视图,你需要在其 ​csrf_exempt()​ 方法上使用 ​dispatch()​,并在实际处理请求的方法上使用 ​csrf_protect()​。示例代码:

from django.utils.decorators import method_decorator
from django.views import View
from django.views.decorators.csrf import csrf_exempt, csrf_protect
@method_decorator(csrf_exempt, name='dispatch')
class UploadFileView(View):
def setup(self, request, *args, **kwargs):
request.upload_handlers.insert(0, ProgressBarUploadHandler(request))
super().setup(request, *args, **kwargs)
@method_decorator(csrf_protect)
def post(self, request, *args, **kwargs):
... # Process request