RSS使用django的ImageField和forms from models快速制作上传图片表单
十二 27
需求描述：
做一个简单的注册页面，使得用户在注册页上传头像。
解决办法：
以前用java写这个的时候，在action上面需要用IO接受文件，然后生成一个文件名，再将文件相对路径保存到user表的img字段中。而在django的model层上，有一个叫做ImageField的字段（还有FileField，两者几乎一样），看了文档中对于这个字段的描述，大致意思就是自动将文件保存在media的文件夹里面，然后产生的文件路径保存到一个var char的字段中。如果一个model有ImageField字段，则在其对应表里面就会有一个var char字段，正是用于保存路径的。
1.设置setting中的MEDIA_ROOT：
如果使用django的快捷方法，那么所有用户上传的文件应该都会被保存到MEDIA_ROOT定义的文件夹中去。注意这里需要绝对路径。我的设置是：
# in settings.py
HERE = os.path.dirname(os.path.abspath(__file__))
MEDIA_ROOT = os.path.join(HERE,'media').replace('\\','/')+'/'
这样就能将MEDIA_ROOT设置为项目目录下的media目录。注意最后的斜杠，如果不加最后的斜杠，那么在保存的时候会出现奇怪的错误。
2.设置model：
为了方便，自己建了一个User的Model：
# in myapp1/models.py
class User(models.Model):
name = models.CharField(max_length=30)
password = models.CharField(max_length=30)
GENDER_CHOICE = (
(u'M', u'Male'),
(u'F', u'Female'),
)
gender = models.CharField(max_length=2,choices = GENDER_CHOICE)
birthday = models.DateField(null=True,blank=True)
img = models.ImageField(upload_to='photo',null=True,blank=True)
phoneNum = models.CharField(max_length=13,null=True,blank=True)
email = models.EmailField(null=True,blank=True)
hobbies = models.CharField(max_length=100,null=True,blank=True)
regTime = models.DateTimeField(null=True,blank=True)
bio = models.TextField(null = True,blank=True)
def __unicode__(self):
return self.name
这里要注意的地方是null=True之后，要也要加上blank=True。其中null=True是针对数据库的，而blank=True是针对validation的。如果blank=True没加，那么在下面做form的时候，省略字段的话验证不会通过。
这里面有一个img字段，是ImageField类型的，这个在快速制作上传图片的表单里起了至关重要的作用。里面有一句upload_to=’xxxxx’，是指文件保存在MEDIA_ROOT中的哪个子目录下。
3.设置forms from models：
django有一个form类，这个类抽象出了html的form。用在view里的话，就能在template里生成form的html。但是可以发现用户注册时，表单的字段和model的字段非常相似，所以可以通过model生成form类。
而model类里面并不是所有的内容都需要用户填写，比如regTime就不需要。这时候可以指定那些字段会成为form字段（使用fields=(xxxx)），或者可以指定哪些字段不会成为form字段（使用exclude=(xxx)）。这里，我们似乎只有一个regTime不需要显示。
另外，我们的model里面password字段是CharField，django不会聪明到通过变量名的意思来生成form，所以默认生成出来的会是input type=”text”的表单，我们需要通过一种方法修改掉它。综上所述，最后的form代码是这样的：
# in myapp1/models.py
from django.db import models
from django.forms import ModelForm
from django import forms
class UserForm(ModelForm):
class Meta:
model = User #通过上面的User Model生成表单
exclude =('regTime')#将regTime字段排除在外
widgets = {
'password':forms.PasswordInput(),#将password字段的input type设为password
}
这样就能生成一个简单的form了。forms from models和普通的form类有一个区别，就是它有save()方法，这个方法在view中将会被使用。
4.在view里调用form
这里，假设注册页面为/reg/。如果使用get方法，则浏览器中给出注册表单，如果用post方法，则将表单内容保存到数据库。
如果使用forms from models，则在view上面将会非常的简单：
#in myapp1/views.py
def reg(request):
if request.method == 'POST':#提交表单
form = models.UserForm(request.POST,request.FILES)#如果表单中要传文件、图片，则需要传两个参数
if form.is_valid():#这个is_valid通过model的配置定义，这里显现出blank=True的意义了
form.save()#这一句save，不但保存了各个字段，而且自动将上传的文件保存到指定目录，并且生成文件路径，保存到user表的img字段中了。
else:#显示表单
form = models.UserForm()
return render_to_response('reg_form.html', {'form': form})
5.template中的使用：
<body>
<form enctype="multipart/form-data" action="/reg/" method="post">
{{ form.as_p }}
<input type="submit" value="Submit" />
</form>
</body>
这里和普通form是一样的。当然也可以手动设置格式，详见文档。
最后再配置一下urlpattern，就能在这个表单上传图片了。
不足：
单单这样做注册表单有个不足之处，就是没有confirm password这个字段。不过我们可以在UserForm类中增加一个表单字段，最后结果会是：
不过这样一来，template中生成的表单，会把confirm_password字段放在最下面。所以得手动设定格式。另外，form.is_valid()也不会监测password和它是不是一样，需要在后面手动加逻辑。
上面的方法不一定是最好的，不过也提供了一些思路。另外，即便是不使用forms from models，也可以方便的使用ImageField保存图片：见http://www.nitinh.com/2009/02/django-example-filefield-and-imagefield/
class UserForm(ModelForm):
confirm_password = forms.CharField(widget=forms.PasswordInput())
class Meta:
model = User
exclude('regTime')
widgets = {
'password':forms.PasswordInput(),
}
访问media目录：
media文件夹里的内容需要使用urlpatterns映射才能访问。在urls里面添加：
urlpatterns += patterns('',
url(r'^media/(?P<path>.*)$', 'django.views.static.serve', {
'document_root': settings.MEDIA_ROOT,
}),
Comments