Django4.0 文件上传-上传 Handlers

当一个用户上传文件时，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