Django2.0-表单(2)-表单的FIeld，验证器，提取错误字段

刺骨的言语ヽ痛彻心扉 2023-06-21 08:52 11阅读 0赞

# 用表单验证数据 #

###    常用的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 models
    
    class 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 forms
    
    class 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_fieldname
        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))  # 抛出异常
                # 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 phone
    
        def 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).']}