用表单验证数据
常用的Field
使用Field可以是对数据验证的第一步。你期望这个提交上来的数据是什么类型,那么就使用什么类型的Field。
可以通过表单类实例.cleaned_data.get("field_name")获得值
CharField
用来接收文本。
参数:
max_length:这个字段值的最大长度。
min_length:这个字段值的最小长度。
required:这个字段是否是必须的。默认是必须的。
error_messages:在某个条件验证失败的时候,给出错误信息。
EmailField
继承于charField,用来接收邮件,会自动验证邮件是否合法。
错误信息的key:required、invalid。
FloatField
用来接收浮点类型,并且如果验证通过后,会将这个字段的值转换为浮点类型。
参数:
max_value:最大的值。
min_value:最小的值。
错误信息的key:required、invalid、max_value、min_value。
IntegerField
用来接收整形,并且验证通过后,会将这个字段的值转换为整形。
参数:
max_value:最大的值。
min_value:最小的值。
错误信息的key:required、invalid、max_value、min_value。
URLField
用来接收url格式的字符串。
错误信息的key:required、invalid。
常用验证器
from django.core import validators
在验证某个字段的时候,可以传递一个validators参数用来指定验证器,进一步对数据进行过滤。验证器有很多,但是很多验证器其实已经通过这个Field或者一些参数就可以指定了。比如EmailValidator,可以通过EmailField来指定,比如MaxValueValidator,可以通过max_value参数来指定。以下是一些常用的验证器:
MaxValueValidator:验证最大值。
MinValueValidator:验证最小值。
MinLengthValidator:验证最小长度。
MaxLengthValidator:验证最大长度。
EmailValidator:验证是否是邮箱格式。
URLValidator:验证是否是URL格式。
RegexValidator:如果还需要更加复杂的验证,那么可以通过正则表达式的验证器:
比如现在要验证手机号码是否合格,那么可以通过以下代码实现:
class MyForm(forms.Form):telephone = forms.CharField(validators=[validators.RegexValidator("1[345678]\d{9}",message='请输入正确格式的手机号码!')])
自定义验证
有时候对一个字段验证,需要一些其他复杂的逻辑,那么可以对该字段,进行自定义的验证。
比如在注册的表单验证中,想要验证手机号码是否已经被注册过了,那么这时候就需要在数据库中进行判断才知道。
对某个字段进行自定义的验证方式是,定义一个方法,这个方法的名字定义规则是:clean_fieldname。 如果验证失败,那么就抛出一个验证错误。
比如要验证用户表中手机号码之前是否在数据库中存在
# models.py
from django.db import modelsclass User(models.Model):username = models.CharField(max_length=100)phone = models.CharField(max_length=11) # 这里没用unique是因为想使用下表单类判断 pwd = models.CharField(max_length=20)<!DOCTYPE html>
<html lang="en">
<head><meta charset="UTF-8"><title>Title</title>
</head>
<body>
<form action="" method="post"><table><tr><td>用户名:</td><td><input type="text" name="username"></td></tr><tr><td>手机号:</td><td><input type="text" name="phone"></td></tr><tr><td>密码:</td><td><input type="password" name="pwd"></td></tr><tr><td>重复密码:</td><td><input type="password" name="pwd_repeat"></td></tr><tr><td></td><td><input type="submit" name="提交"></td></tr></table></form></body>
</html>
from django import formsclass RegisterTable(forms.Form):username = forms.CharField(min_length=1,max_length=10)phone = forms.CharField(validators=[validators.RegexValidator("1[345678]\d{9}", message="请输入正确的手机号码")]) # message会在表单类.errors.get_json_data()中获得# 对某个字段进行自定义的验证方式是,定义一个方法,这个方法的名字定义规则是:clean_fieldnamedef clean_phone(self):phone = self.cleaned_data.get("phone") # 获得字段数据ret = User.objects.filter(phone=phone).exists() # 如果已存在if ret:raise forms.ValidationError(message="{}已经被注册".format(phone)) # 抛出异常# message会在表单类.errors.get_json_data()中获得else:return phone
如果验证数据时,需要针对多个字段进行验证,那么可以重写clean方法。
比如要在注册的时候,要判断提交的两个密码是否相等。那么可以使用以下代码来完成:
class RegisterTable(forms.Form):username = forms.CharField(min_length=1,max_length=10)phone = forms.CharField(validators=[validators.RegexValidator("1[345678]\d{9}", message="请输入正确的手机号码")])pwd = forms.CharField(min_length=5) #密码pwd_repeat = forms.CharField(min_length=5) #重复的密码def clean_phone(self):phone = self.cleaned_data.get("phone") ret = User.objects.filter(phone=phone).exists()if ret:raise forms.ValidationError(message="{}已经被注册".format(phone))return phonedef clean(self): #最后审查ret = super(RegisterTable, self).clean()pwd = ret.get("pwd") # ==self.cleaned_data.get("pwd")pwd_repeat = ret.get("pwd_repeat")if pwd != pwd_repeat:raise forms.ValidationError(message="密码不一致")else:return ret
提取错误信息
如果验证失败了,那么有一些错误信息是需要传给前端的。这时候可以通过以下属性来获取:
form.errors:这个属性获取的错误信息是一个包含了html标签的错误信息。
form.errors.get_json_data():这个方法获取到的是一个字典类型的错误信息。将某个字段的名字作为key,错误信息作为值的一个字典。
form.as_json():这个方法是将form.get_json_data()返回的字典dump成json格式的字符串,方便进行传输。
上述方法获取的字段的错误值,都是一个比较复杂的数据。比如以下:
{'username': [{'message': 'Enter a valid URL.', 'code': 'invalid'}, {'message': 'Ensure this value has at most 4 characters (it has 22).', 'code': 'max_length'}]}
那么如果只想把错误信息放在一个列表中,而不要再放在一个字典中。这时候可以定义一个方法,把这个数据重新整理一份。实例代码如下:
class MyForm(forms.Form):username = forms.URLField(max_length=4)def get_errors(self):errors = self.errors.get_json_data()new_errors = {}for key,message_dicts in errors.items(): # key是表单字段, message_dicts是字段对应的值(一个list,里面保存错误的字典)messages = []for message in message_dicts:messages.append(message['message']) # message键对应的值存储new_errors[key] = messages # 保存表单字段的message键对应的值return new_errors
这样就可以把某个字段所有的错误信息直接放在这个列表中
{'username': ['Enter a valid URL.', 'Ensure this value has at most 4 characters (it has 22).']}