今天分享一下Django实现的简单的文件上传的小例子。
步骤
- 创建Django项目,创建Django应用
- 设计模型
- 处理urls.py 以及views.py
- 设计模板,设计表单
- 运行项目,查看数据库
下面我们就一起来分别完成每一个小部分吧。
创建项目和应用
django-admin startproject Django_upload
django-admin startapp app
添加一个名为upload的目录,待会要用哦。
然后记得在settings.py 中的INSTALLED_APPS中加上'app',
。注意那个小逗号就行了~~
设计模型
上传文件需要知道是谁上传的,上传了什么。所以我们的 模型很简单,一个用户名,一个文件名即可。如下app.models.py
from __future__ import unicode_literals
from django.db import models
# Create your models here.
# User CLass for user,username and userimg path
class NormalUser(models.Model):
username = models.CharField(max_length=30)
headImg = models.FileField(upload_to='./upload')
def __unicode__(self):
return self.username
class Meta:
ordering = ['username']
模型创建完成了,接下来我们就赶紧同步一下数据库吧。命令很简单,由于我的Django版本是1.9.6的, 所以原来的
python manage.py syncdb 不能用了
我们可以使用下面的命令来代替
python manage.py makemigrations
python manage.py migrate
urls.py 以及 views.py
这两个文件就是为了实现MVC模型的V,C而存在的。
views.py 如下:
from django.shortcuts import render,render_to_response
from django import forms
from django.http import HttpResponse
from app.models import *
# Create your views here.
class NormalUserForm(forms.Form):
username = forms.CharField()
headImg = forms.FileField()
def registerNormalUser(request):
if request.method == "POST":
uf = NormalUserForm(request.POST,request.FILES)
if uf.is_valid():
# get the info of the form
username = uf.cleaned_data['username']
headImg = uf.cleaned_data['headImg']
# write in database
normalUser = NormalUser()
normalUser.username = username
normalUser.headImg = headImg
normalUser.save()
return HttpResponse('Upload Succeed!')
else:
uf = NormalUserForm()
return render(request,'register.html',{'uf':uf})
urls.py
"""Django_upload URL Configuration
The `urlpatterns` list routes URLs to views. For more information please see:
https://docs.djangoproject.com/en/1.9/topics/http/urls/
Examples:
Function views
1. Add an import: from my_app import views
2. Add a URL to urlpatterns: url(r'^$', views.home, name='home')
Class-based views
1. Add an import: from other_app.views import Home
2. Add a URL to urlpatterns: url(r'^$', Home.as_view(), name='home')
Including another URLconf
1. Import the include() function: from django.conf.urls import url, include
2. Add a URL to urlpatterns: url(r'^blog/', include('blog.urls'))
"""
from django.conf.urls import url
from django.contrib import admin
from app.views import *
urlpatterns = [
url(r'^admin/', admin.site.urls),
url(r'^register/$',registerNormalUser),
]
一般来说我们会创建一个超级管理员,命令如下:
python manage.py createsuperuser
然后按照相应的提示进行创建就可以了。
设计模板以及表单
其实刚才就可以在views.py中看到一个为NormalUserForm的类,其存在的意义就是方便从request中取得我们需要的表单数据。而且,恐怕你也注意到了,NormalUserForm的字段和NormalUser模型是一样的呢。各中哲理自己品味吧 :-)
templates/register.html
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>Register</title>
</head>
<body>
<h2 align="center">Register</h2>
<form method="POST" enctype="multipart/form-data">
{% csrf_token %}
{{ uf.as_p }}
<input type="submit" value="Submit">
</form>
</body>
</html>
这里面比较重要的地方有三点:
<form method="POST" enctype="multipart/form-data">
: 表单特定的格式,注意上传数据的时候把enctype明确就可以- {% csrf_token %}: 跨域请求,我们需要在表单标签的内部加上这个模板标签,而且要在views.py中配合render而不是render_to_response来实现
- {{ uf.as_p }}: 使用.as_p 方式的话,django就会按照默认的样式在模板页面输出表单的所有的字段。
调试,开启应用
好了,大部分的任务都做好了,下面就打开我们的开发服务器来验证一下吧。
python manage.py runserver
打开浏览器输入
http://127.0.0.1:8000/register
然后按要求填写表单,就可以了。彩蛋就是加上了is_valid()方法的views.py会自动的帮助我们对表单数据字段进行验证!
打开我们的数据库管理软件,就会发现里面存储的只是路径,而并不是真正的数据。这也体现了大数据存储的核心理念了。点击upload目录,发现文件确实上传成功了!
总结
今天的这个小例子虽然很简单,但是里面也有很多值得我们推敲的地方,我的收获如下。
- 使用models.FileField()实现文件上传组件
- 对应模型添加一个表单类,字段相同。这样对于表单数据的获取会更加更加的方便。
uf = NormalUserForm(request.POST,request.FILES)
。 - 模板界面表单enctype格式,以及.as_p方式的在html页面上的表单输出
就是这样了!