按照上篇文章的計劃,本文應當講解文件上傳功能的用法。但在學習文件上傳之前,我們有必要學習下表單。因為文件上傳經常以表單形式提交。因為使用GET方式提交表單方式比較少見,所以我以POST方式來講解表單的用法。畢竟POST方式對應于GET方式應用比較廣泛些。
1 POST提交表單
Django框架確實強大,其中內嵌的表單幫你處理好很多東西。你會發現用起來十分順手。接下來我們一起來感受下Django強大之處。
1)在你的Application文件夾下新建一個 forms.py 文件
from django import forms
class AddForm(forms.Form):
fileName = forms.CharField(label='文件名', max_length=100)
fileSize = forms.CharField(label='文件大小')
CharField代表是字符字段,它是forms內置的字符。想到了解更多的字段,可以去看下Django源碼中django.forms.fields
這個文件。
然后label這個有什么用呢?我想賣個關子,等會你就知道了。
2)在視圖函數 views.py 中
# 引入我們自己創建的表單類
from .forms import AddForm
def forms(request):
if request.method == 'POST': # 以POST方式提交表單
form = AddForm(request.POST) # form 包含提交的數據
if form.is_valid(): # 如果提交的數據合法
fileName = form.cleaned_data['fileName']
fileSize = form.cleaned_data['fileSize']
return HttpResponse('fileName = ' + fileName + '<br>' +
'fileSize = ' + fileSize)
else: # 當正常訪問時
form = AddForm()
return render(request, 'forms.html', {'form': form})
3)對應的forms.html模版
<!DOCTYPE html>
<html>
<head>
<title>提交表單</title>
</head>
<body>
<form action="/forms/" method="post">
{% csrf_token %}
{{ form }}
<input type="submit" value="提交" />
</form>
</body>
</html>
提交的頁面還是本頁面,提交方式是POST。
表格后面還有一個{% csrf_token %}的標簽。csrf全稱是Cross Site Request Forgery。這是Django提供的防止偽裝提交請求的功能。POST方法提交的表格,必須有此標簽。
4)在 urls.py 中對應寫上這個函數
urlpatterns = [
url(r'^admin/', admin.site.urls),
url(r'^forms/$', views.forms, name='forms')
]
5)運行測試
使用瀏覽器訪問 127.0.0.1:8000/forms/ 這頁面。你會發現:呀!居然有輸入框。我們在 forms.html 中并沒有添加相對應標簽和輸入框啊。這就是Django強大之處,它會根據forms字段來渲染出相對應的控件的。
如果你沒有填寫任何信息,Django頁面內部幫你做簡單判空處理。
正常輸入內容
返回的結果如下:
2 文件上傳
如果你把表單學會了,可以往下學習。如果還沒有掌握,建議你把表單弄懂再學習文件上傳。有了表單的基礎,再學習文件上傳則易如反掌。我以簡單的表單來上傳文件。文件上傳高級用法有利用模型處理上傳、管理和存儲文件。還是上面的套路
1)在你的Application文件夾下新建一個 名為UploadFileForm.py 文件
from django import forms
# 文件上傳表單
class UploadFile(forms.Form):
file = forms.FileField('文件')
# 處理文件的方法
def handle_uploaded_file(f, filename):
with open('/media/filename', 'wb+') as destination:
for chunk in f.chunks():
destination.write(chunk)
對于文件的遍歷,不易采用read()方法。上傳的文件可能還是大文件,例如100m大小的視頻文件。如果一下子讀取到內存中可能會內存被擠爆了。所以使用UploadedFile.chunks()
保險點
2)在視圖函數 views.py 中
from .UploadFileForm import UploadFile
from .UploadFileForm import handle_uploaded_file
import datetime
def upload(request):
if request.method == 'POST':
form = UploadFile(request.POST, request.FILES)
if form.is_valid():
filename = datetime.datetime.now().strftime("%Y-%m-%d %H:%M:%S") # 以當前時間為文件名
handle_uploaded_file(request.FILES['file'], filename)
return HttpResponse('上傳成功')
else:
form = UploadFile()
return render('upload.html', {'form': form})
處理這個表單的視圖會在request中接收到上傳文件的數據。FILES是個字典,它包含每個FileField的鍵 (或者 ImageField,FileField的子類)。這樣的話就可以用request.FILES['file']來存放表單中的這些數據了。
注意request.FILES 只有在請求方法為POST,并且發送請求的<form>擁有enctype="multipart/form-data" 屬性時,才會包含數據。否則request.FILES 為空。
3)對應的 upload.html 模版
<!DOCTYPE html>
<html>
<head>
<title>上傳文件</title>
</head>
<body>
<form action="/upload/" method="post">
{% csrf_token %}
{{ form }}
<input type="submit" value="提交" />
</form>
</body>
</html>
4)再在 urls.py 中對應寫上這個函數
urlpatterns = [
url(r'^admin/', admin.site.urls),
url(r'^upload/$', views.upload, name='upload')
]
最后運行測試即可,在此就不演示了。
文本主要講解表單和文件上傳的簡單用法,想要深入更多東西,可以查閱文檔學習。
系列文章:
Django學習之旅(一)
Django學習之旅(二)
Django學習之旅(三)
Django學習之旅(四)
Django學習之旅(六)
推薦閱讀:
爬蟲系列的總結