Django文件上传处理详解：从HttpRequest.FILES到ModelField存储
本文深入解析Django中文件上传的处理机制，涵盖HttpRequest.FILES的读取、UploadedFile类的属性与方法，以及通过Form和Model两种方式存储文件的完整流程。内容包含手动处理、Form表单验证及ModelField自动保存的代码示例，帮助开发者实现灵活且安全的文件上传功能。
HttpRequest.FILES
在Django中，通过HTML表单上传的文件对象会被存储在request.FILES这个类字典对象中。需要注意的是，发起上传请求的HTML表单必须设置enctype属性为multipart/form-data，否则文件数据无法正确传递。
<form enctype="multipart/form-data" method="post" action="/foo/"> <input type="file" name="image" />
request.FILES字典中的键名直接对应于HTML表单中<input type="file" name="...">标签的name属性值。
img=request.FILES['image']
request.FILES中存储的值均为UploadedFile类的实例，这是一种特殊的文件对象，封装了上传文件的元数据和内容。
UploadedFile
UploadedFile作为类文件对象，提供了多种用于读取和操作上传文件的方法及属性，具体如下：
UploadedFile.read()
调用read()方法可以一次性读取整个上传文件的数据。需要注意的是，如果上传文件体积较大，此操作会消耗大量内存，因此应谨慎使用。
UploadedFile.multiple_chunks(chunk_size=None)
multiple_chunks()方法用于判断文件是否足够大，其默认阈值通常为2.5MB。
UploadedFile.chunks(chunk_size=None)
当multiple_chunks()返回True时，建议使用chunks()方法。该方法返回一个生成器对象，允许分块读取文件内容，从而避免内存溢出。
UploadedFile.name
name属性返回上传文件的原始文件名。
UploadedFile.size
size属性返回上传文件的大小，单位为字节。
UploadedFile.content_type
content_type属性返回上传文件时HTTP请求头中的Content-Type值，例如text/plain或application/pdf。
UpladedFile.charset
charset属性用于指定文件的编码方式。
存储文件
若需将上传的文件直接存储在本地服务器文件系统中，可参考以下处理方式。
f=request.FILES['image']
with open('some/file/name.txt', 'wb+') as destination:
for chunk in f.chunks():
destination.write(chunk)
使用Form处理上传文件
Django提供了内置的Form机制来处理上传文件，这比手动处理request.FILES更为规范和便捷。
首先，需要创建一个包含FileField或ImageField字段的Form类。
# In forms.py... from django import forms class UploadFileForm(forms.Form): title = forms.CharField(max_length=50) file = forms.FileField()
在视图函数中实例化该Form，并传入request.POST和request.FILES进行验证和处理。
>>> f =UploadFileFormt(request.POST, request.FILES)
对应的视图函数逻辑如下：
from django.http import HttpResponseRedirect
from django.shortcuts import render_to_response
from .forms import UploadFileForm
def handle_uploaded_file(f):
with open('some/file/name.txt', 'wb+') as destination:
for chunk in f.chunks():
destination.write(chunk)
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_to_response('upload.html', {'form': form})
使用Model处理上传文件
如果模型中定义了FileField或ImageField字段，通常需要将上传的文件直接存储到该Model实例对应的字段中。
例如，在使用nicEdit文本编辑器时，可能需要存储用户上传的图片，此时可以建立如下Model。
from django.db import models class NicEditImage(models.Model): image = models.ImageField(upload_to='nicedit/%Y/%m/%d')
接着，创建对应的ModelForm以简化表单处理。
from django import forms class NicEditImageForm(forms.ModelForm): class Meta: model = NicEditImage
视图函数中调用ModelForm的save()方法即可自动保存文件。
def upload(request):
if not request.user.is_authenticated():
json = simplejson.dumps({
'success': False,
'errors': {'__all__': 'Authentication required'}})
return HttpResponse(json, mimetype='application/json')
form = NicEditImageForm(request.POST or None, request.FILES or None)
if form.is_valid():
image = form.save() #保存Form和Model
json = simplejson.dumps({
'success': True,
'upload': {
'links': {
'original': image.image.url},
'image': {
'width': image.image.width,
'height': image.image.height}
}
})
else:
json = simplejson.dumps({
'success': False, 'errors': form.errors})
return HttpResponse(json, mimetype='application/json')
当然，开发者也可以选择不依赖Form，而是手动将文件保存到Model的文件字段中。
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']) #保存文件到FileField域
instance.save()
return HttpResponseRedirect('/success/url/')
else:
form = UploadFileForm()
return render(request, 'upload.html', {'form': form})
不使用Form处理
当需要更大的控制自由度时，可以完全手动处理文件上传和存储逻辑。
from django.db import models class Car(models.Model): name = models.CharField(max_length=255) price = models.DecimalField(max_digits=5, decimal_places=2) photo = models.ImageField(upload_to='cars')
Model中的FileField字段具有以下关键属性：
>>> car = Car.objects.get(name="57 Chevy") >>> car.photo <ImageFieldFile: chevy.jpg> >>> car.photo.name u'cars/chevy.jpg' >>> car.photo.path u'/media/cars/chevy.jpg' >>> car.photo.url u'http://media.example.com/cars/chevy.jpg'
Model的FileField是一个File对象实例，除了具备标准File对象的各种方法外，还额外提供了一个save()方法用于持久化存储。
FieldFile.save(name, content, save=True)
save()方法接收name（存储文件名）和content（File或其子类的实例）作为参数。
>>> car.photo.save('myphoto.jpg', content, save=False)
>>> car.save()
其用法类似于直接调用save()方法并指定参数。
>>> car.photo.save('myphoto.jpg', content, save=True)
手动存储文件到Model的示例代码如下：
from django.core.files.base import ContentFile
photo=request.FILES.get('photo','')
if photo:
file_content = ContentFile(photo.read()) #创建File对象
car.photo.save(photo.name, file_content) #保存文件到car的photo域
car.save()
以上这篇Django处理文件上传File Uploads的实例就是小编分享给大家的全部内容了，希望能给大家一个参考，也希望大家多多支持本站。
本站声明
本文内容仅供参考，不代表本站观点。转载或引用请注明出处。如发现内容问题，请通过联系我们页面反馈。
