验证器是一个可调用的对象,它接受一个值,并在不符合一些规则时抛出ValidationError异常。验证器有助于在不同类型的字段之间重复使用验证逻辑。
例如,这个验证器只允许偶数:
from django.core.exceptions import ValidationError
def validate_even(value):
if value % 2 != 0:
raise ValidationError('%s is not an even number' % value)
你可以通过字段的validators参数将它添加到模型字段中:
from django.db import models
class MyModel(models.Model):
even_field = models.IntegerField(validators=[validate_even])
由于值在验证器运行之前会转化为Python,你可以在表单上使用相同的验证器:
from django import forms
class MyForm(forms.Form):
even_field = forms.IntegerField(validators=[validate_even])
你也可以使用带有 __call__()方法的类,来实现更复杂或可配置的验证器。例如,RegexValidator就用了这种技巧。如果一个基于类的验证器用于validators模型字段的选项,你应该通过添加deconstruct() 和__eq__() 方法确保它可以被迁移框架序列化。
关于验证器如何在表单中运行,详见表单验证 。关于它们如何在模型中运行,详见 验证对象。要注意验证器不会在你保存模型时自动运行,但是如果你使用ModelForm,它会在任何你表单包含的字段上运行你的验证器。关于模型验证器如何和表单交互,详见ModelForm 文档。
django.core.validators模块包含了一系列的可调用验证器,用于模型和表单字段。它们在内部使用,但是也可以用在你自己的字段上。它们可以用在field.clean() 方法之外,或者代替它。
参数: |
---|
用于搜索提供的value的正则表达式,或者是预编译的正则表达式对象。通常在找不到匹配时抛出带有 message 和code的 ValidationError异常。这一标准行为可以通过设置inverse_match 为True来反转,这种情况下,如果找到匹配则抛出 ValidationError异常。通常它会匹配任何字符串(包括空字符串)。
验证失败时ValidationError所使用的错误信息。默认为"Enter a valid value"。
验证失败时ValidationError所使用的错误代码。默认为"invalid"。
参数: |
---|
验证失败时ValidationError所使用的错误信息。默认为"Enter a valid email address"。
验证失败时ValidationError所使用的错误代码。默认为"invalid"。
所允许的邮件域名的白名单。通常,正则表达式(domain_regex 属性) 用于验证 @ 符号后面的任何东西。但是,如果这个字符串在白名单里,就可以通过验证。如果没有提供,默认的白名单是 ['localhost']。其它不包含点符号的域名不能通过验证,所以你需要按需将它们添加进白名单。
RegexValidator确保一个值看起来像是URL,并且如果不是的话产生'invalid'错误代码。
回送地址以及保留的IP空间被视为有效。同时也支持字面的IPv6地址 (RFC 2732) 以及unicode域名。
除了父类RegexValidator的可选参数之外,URLValidator接受一个额外的可选属性:
添加了可选的schemes 属性。
添加了对IPv6 地址, unicode 域名, 以及含有验证信息的URL的支持。
一个不带有任何自定义的EmailValidator实例。
一个 RegexValidator实例,确保值只含有字母、数字、下划线和连字符。
一个RegexValidator的实例,确保值是IPv4地址。
一个RegexValidator的实例,确保值是整数的逗号分隔列表。
如果value 大于 max_value,抛出带有'max_value'代码的ValidationError 异常。
添加了message参数。
如果value小于min_value,抛出带有'min_value'代码的ValidationError异常。
添加了message 参数。
如果value的长度大于max_length,抛出带有'max_length'代码的ValidationError 异常。
添加了message参数。
如果value的长度小于min_length,抛出带有'min_length'代码的ValidationError异常。
添加了message 参数。
2015年5月13日