Django 是一个强大的 Python Web 框架,它提供了一系列的功能来帮助开发者快速构建 Web 应用程序。其中之一就是文件上传功能,它可以让用户上传文件到服务器,从而使得应用程序可以处理这些文件。
在 Django 中,文件上传是通过使用 FileField 或 ImageField 类来实现的。FileField 和 ImageField 都是 Django 提供的字段类型,它们都可以被用来存储文件。FileField 用于存储所有类型的文件,而 ImageField 则专门用于存储图片文件。
class MyModel(models.Model): file_field = models.FileField(upload_to='files/') image_field = models.ImageField(upload_to='images/')
上面代码中,我们创建了一个名为 MyModel 的模型,并添加了两个字段 file_field 和 image_field。file_field 使用 FileField 类来存储所有类型的文件,image_field 使用 ImageField 类来存储图片文件。upload_to 参数表明该字段将上传的文件放在 MEDIA_ROOT/files/ 或 MEDIA_ROOT/images/ 目录中。
当我们在表单中包含这两个字段时,Django 会自动生成一个 HTML 表单元素 :
当用户选择要上传的文件后,Django 会将该文件放在 MEDIA_ROOT/files/ 或 MEDIA_ROOT/images/ 目录中并把该目录中的相对路径保存到数据库中。
此外,Django 还提供了一些高级特性来帮助开发者处理上传的文件。例如:Storage API 允许开发者将上传的文件放在不同位置、Form API 允许开发者对表单进行验证、Views API 允许开发者处理 POST 请求并把数据保存到数据库中、Serializers API 允许开发者将数据序列化成 JSON 或 XML 等格式。
总之,Django 提供了一套完整而先进的工具来帮助开发者快速实现 Web 应用系统中的文件上传功能。
考虑一个包含 FileField
的表单:
from django import forms
class UploadFileForm(forms.Form):
title = forms.CharField(max_length=50)
file = forms.FileField()
处理这个表单的视图将在 request.FILES
中接收文件数据,它是一个字典,包含表单中每个 FileField
(或 ImageField
,或其他 FileField
子类)的键。所以上述表单中的数据将以 request.FILES["file"]
的形式被访问。
注意 request.FILES
只有当请求方法是 POST
,至少有一个文件字段被实际发布,并且发布请求的 <form>
有 enctype="multipart/form-data"
属性时,才会包含数据。否则 request.FILES
将为空。
大多数情况下,你需要像将上传的文件绑定到表单中 里描述的那样将文件数据从 request
传递给表单。示例如下:
from django.http import HttpResponseRedirect
from django.shortcuts import render
from .forms import UploadFileForm
# Imaginary function to handle an uploaded file.
from somewhere import handle_uploaded_file
def upload_file(request):
if request.method == "POST":
form = UploadFileForm(request.POST, request.FILES)
if form.is_valid():
handle_uploaded_file(request.FILES["file"])
return HttpResponseRedirect("/success/url/")
else:
form = UploadFileForm()
return render(request, "upload.html", {"form": form})
注意我们必须将 request.FILES
传入到表单的 构造方法中,只有这样文件数据才能绑定到表单中。
我们通常可能像这样处理上传文件:
def handle_uploaded_file(f):
with open("some/file/name.txt", "wb+") as destination:
for chunk in f.chunks():
destination.write(chunk)
使用 UploadedFile.chunks()
而不是 read()
是为了确保即使是大文件也不会将我们系统的内存占满。
如果想要在 FileField
上的 Model
保存文件,使用 ModelForm
会让这一过程变得简单。当调用 form.save()
时,文件对象将会被保存在对相应 FileField
的 upload_to
参数所指定的地方:
from django.http import HttpResponseRedirect
from django.shortcuts import render
from .forms import ModelFormWithFileField
def upload_file(request):
if request.method == "POST":
form = ModelFormWithFileField(request.POST, request.FILES)
if form.is_valid():
# file is saved
form.save()
return HttpResponseRedirect("/success/url/")
else:
form = ModelFormWithFileField()
return render(request, "upload.html", {"form": form})
如果你准备手工构建对象,你可以指定来自 request.FILES
的文件对象到模型里的文件对象:
from django.http import HttpResponseRedirect
from django.shortcuts import render
from .forms import UploadFileForm
from .models import ModelWithFileField
def upload_file(request):
if request.method == "POST":
form = UploadFileForm(request.POST, request.FILES)
if form.is_valid():
instance = ModelWithFileField(file_field=request.FILES["file"])
instance.save()
return HttpResponseRedirect("/success/url/")
else:
form = UploadFileForm()
return render(request, "upload.html", {"form": form})
如果您在请求之外手动构建对象,则可以将类似文件的对象分配给 FileField
:
from django.core.management.base import BaseCommand
from django.core.files.base import ContentFile
class MyCommand(BaseCommand):
def handle(self, *args, **options):
content_file = ContentFile(b"Hello world!", name="hello-world.txt")
instance = ModelWithFileField(file_field=content_file)
instance.save()
如果你想使用一个表单字段上传多个文件,则需要设置字段的 widget
的 multiple HTML
属性。
from django import forms
class FileFieldForm(forms.Form):
file_field = forms.FileField(widget=forms.ClearableFileInput(attrs={"multiple": True}))
然后覆盖 FormView
子类的 post
方法来控制多个文件上传:
from django.views.generic.edit import FormView
from .forms import FileFieldForm
class FileFieldFormView(FormView):
form_class = FileFieldForm
template_name = "upload.html" # Replace with your template.
success_url = "..." # Replace with your URL or reverse().
def post(self, request, *args, **kwargs):
form_class = self.get_form_class()
form = self.get_form(form_class)
files = request.FILES.getlist("file_field")
if form.is_valid():
for f in files:
... # Do something with each file.
return self.form_valid(form)
else:
return self.form_invalid(form)
例如:在最基本的层面上,使用 filter 和 exclude 在数据库中进行过滤。使用 F 表达式 根据同一模型中的其他字段进...
模型准确且唯一的描述了数据。它包含您储存的数据的重要字段和行为。一般来说,每一个模型都映射一张数据库表。基础:每个模型都...
本文将介绍 MybatisPlus 注解包相关类详解@TableName描述:表名注解,标识实体类对应的表使用位置:实体类@TableName("sys_user"...
MyBatis-Plus 条件构造器-AbstractWrapperle(R column, Object val)le(boolean condition, R column, Object val)小于等于=例:...
MyBatis-Plus 条件构造器-AbstractWrapperorderBy(boolean condition, boolean isAsc, R... columns)排序:ORDERBY字段,...例:...
Spring教程 -Spring Bean属性我们可以通过几种方式将数据填充到Spring配置XML中定义的Java Bean中。以下部分显示将值注入定义的 ...
Spring教程 - 弹簧依赖检查Spring可以做依赖检查以确保已设置或注入所需的属性。Spring可以做依赖检查以确保已设置或注入所需的...
JSP教程 -JSP发送电子邮件要使用JSP发送电子邮件,请在CLASSPATH中安装JavaMail API和Java Activation Framework(JAF)。发送电子...
sql:setDataSource标签用来配置数据源或者将数据源信息存储在某作用域的变量中,用来作为其它JSTL数据库操作的数据源。语法格式s...