Django处理文件上传File Uploads

HttpRequest.FILES

表单上传的文件对象存储在类字典对象request.FILES中，表单格式需为multipart/form-data

1 2	<form enctype= "multipart/form-data" method= "post" action= "/foo/" > <input type= "file" name= "image" />

request.FILES中的键来自于表单中的<input type="file" name="" />的name值：

1	img=request.FILES[ 'image' ]

request.FILES中的值均为UploadedFile类文件对象。

UploadedFile

UploadedFile是类文件对象，具有以下方法和属性：

UploadedFile.read()

读取整个上传文件的数据，文件较大时慎用。

UploadedFile.multiple_chunks(chunk_size=None)

判断文件是否足够大，一般为2.5M

UploadedFile.chunks(chunk_size=None)

返回一个生成器对象，当multiple_chunks()为True时应该使用这个方法来代替read().

UploadedFile.name

上传文件的name。

UploadedFile.size

上传文件的大小。

UploadedFile.content_type

上传文件时的content_type报头，例如(e.g. text/plain or application/pdf). 

UpladedFile.charset

编码

存储文件

想将上传的文件存储在本地时：

1 2 3 4

f=request.FILES[ 'image' ] with open( 'some/file/name.txt' , 'wb+' ) as destination:      for chunk in f.chunks():          destination.write(chunk)

使用Form处理上传文件

也可以使用django自带的form来处理上传文件。

先创建带FileFiled或者ImageFiled的Form：

1 2 3 4 5 6

# In forms.py... from django import forms   class UploadFileForm(forms.Form):      title = forms.CharField(max_length=50)      file = forms.FileField()

用Form处理：

1	>>> f =UploadFileFormt(request.POST, request.FILES)

view函数：

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18

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，需要将上传文件存储到Model的FileFIeld域。

比如，使用nicEdit文本编辑器时，需要存储上传的文件，建立Model：

1 2 3 4

from django.db import models   class NicEditImage(models.Model):      image = models.ImageField(upload_to= 'nicedit/%Y/%m/%d' )

创建ModelForm：

1 2 3 4 5

from django import forms   class NicEditImageForm(forms.ModelForm):      class Meta:          model = NicEditImage

view：

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23

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' )

当然也可以手动存储文件到Model的文件域：

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15

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处理

想获得更大自由度时，可以全手动处理。

1 2 3 4 5 6

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有以下属性：

1 2 3 4 5 6 7 8 9

>>> 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)

　name为存储名字，content为File或者File子类的实例

1 2	>>> car.photo.save( 'myphoto.jpg' , content, save=False) >>> car.save()

类似于

1	>>> car.photo.save( 'myphoto.jpg' , content, save=True)

手动存储：

1 2 3 4 5 6

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()