Django Form表单学习总结
Form中添加自定义的验证:
1.对特定字段属性的验证;
2.包含多字段的验证.
先创建一个简单的Form:
from django import forms
class ContactForm(forms.Form):
subject = forms.CharField(max_length=100)
message = forms.CharField()
sender = forms.EmailField()
recipients = MultiEmailField()
cc_myself = forms.BooleanField(required=False)
1.验证特定字段属性
使用表单子类中的clean_<fieldname>()
方法 -- <fieldname>通过表单中的字段名称替换.这个方法完成特定属性相关的验证,这个验证与字段的类型无关.这个方法没有任何传入的参数.你需要查找self.cleaned_data
中该字段的值,记住此时它已经是一个python对象而不是表单中提交的原始字符串(它位于cleaned_data
中是因为字段的clean()
方法已经验证过一次数据).
例如,在ContactForm
中,我们想确保recipients
字段始终包含'fred@example.com'.这是特定于我们这个表单的验证,所以我们打算将它放在通用的MultiEmailField
类中.编写一个运行在recipients
字段上的验证方法:
from django import forms
class ContactForm(forms.Form):
#Everything as before
...
def clean_recipients(self):
data = self.cleaned_data['recipients']
if 'fred@example.com' not in data:
raise forms.ValidationError('You havev forgotten Fred!')
# Always return a value to use as the new cleaned data, even if this method didn't change it
return data
2.验证相互依赖的字段
假设我们添加另外一个需求到联系人表单中:如果cc_myself
字段为True
,那么subject
必须包含单词'help'.这个验证包含多个字段,所以表单的clean()
方法是个不错的地方.
注意,这里讨论的是表单的clean()
方法,上面有提到一个字段的clean()
方法.区别字段和表单之间的差别非常重要,字段是单个数据,表单是字段的集合.
在调用表单clean()
方法的时候,所有字段的验证方法已经执行完,所以self.cleaned_data
填充的是目前为止已经合法的数据.所以需要记住一个事实,你需要验证的字段可能没有通过初始的字段检查!
from django import forms
class ContactForm(forms.Form):
# Everything as before
...
def clean(self):
cleaned_data = super(ContactForm, self).clean()
cc_myself = cleaned_data.get('cc_myself')
subject = cleaned_data.get('subject')
if cc_myself and subject:
# Only do something if both fields are valid so far.
if 'help' not in subject:
raise forms.ValidationError("Did not send for 'help' in the subject despite CC'ing yourself")
在这段代码中,如果抛出验证错误,表单将在表单的顶部显示(通常是)描述该问题的一个错误信息。
注意,示例代码中super(ContactForm, self).clean()
的调用是为了保证维持父类中的验证逻辑。
3.多表单提交的外键处理
假设有多个模型之间存在外键关系,那么在同一个页面同时提交这几个表单的处理方法:
建立几个模型:
from django.db import models
class Store(models.Model):
...
class Deport(models.Model):
s_name = models.ForeignKey(Store)
...
class Address(models.Model):
s_name = models.ForeignKey(Store)
...
给这几个模型分别建立模型表单.
由于其中两个表使用了1个外键约束,如果同时提交和保存数据会导致数据表中的s_name_id
字段值为NULL
.为了解决这个问题,我们采用延迟提交给数据库的方式.
ModelForm的save()方法接受一个可选的commit
关键字参数,其值为True/False
.如果save()
时commit=False
,那么它将返回一个还没保存到数据库的模型实例对象.这种情况下,你需要调用该返回的模型实例的save()
方法.这样你可以在保存数据之前进行一些自定义的处理.commit
默认为True
.
from django.views.generic.base import View
class Store_Add(View):
...
def post(self, request):
sf = StoreForm(request.POST)
df = DeportForm(request.POST)
af = AddressForm(request.POST)
if sf.is_valid() and df.is_valid() and af.is_valid():
store = sf.save()
dform = df.save(commit=False) # 将来自DeportForm的数据暂存为一个模型实例,其中s_name字段为空
dform.s_name = store
dform.save()
aform = af.save(commit=False)
aform.s_name = store
aform.save()
...
4.从表单中访问字段
可以通过表单的fields
属性访问字段:
#models.py
from django.db import models
class Publisher(models.Model):
name = models.CharField(max_length=30)
address = models.CharField(max_length=50)
website = models.URLField()
def __str__(self):
return self.name
#forms.py
from django import forms
from myapp.models import Publisher
class PublisherForm(forms.ModelForm):
class Meta:
model = Publisher
fields = '__all__'
>>> form = PublisherForm()
>>> form.fields
# 返回一个有序字典对象,键为Form中的字段名,值为fields对象
OrderedDict([('name', <django.forms.fields.CharField at 0x1d075ebca90>),
('address', <django.forms.fields.CharField at 0x1d075ebcb38>),
('website', <django.forms.fields.URLField at 0x1d07696cc18>)])
可以使用字典的方法对Form的字段进行一些操作,例如:
form.fields.update({'website': forms.CharField(widget=forms.TextInput()})
后者动态的对某一个字段的属性进行修改:
form.fields['website'].initial = self.request.user.website
fields对象的一些参数(属性)参考文档中的说明.
参考:http://python.usyiyi.cn/translate/django_182/ref/forms/validation.html#validating-fields-with-clean
https://segmentfault.com/a/1190000007183873