Django Forms 的一个强大特点是 验证。它会在用户将输入的数据发送到服务器之前自动进行验证，从而确保安全性和准确性。本文将探索 Django Forms 的验证机制以及如何自定义验证。

1. 基本验证

展示 Django Forms 验证工作流程的图示，包括表单提交、字段验证和错误处理等关键步骤

1.1 什么是验证？

Django Forms 确保数据满足表单字段的要求。这个过程包括表单提供的基本验证和开发者额外定义的自定义验证。

基本验证示例
from django import forms

class RegistrationForm(forms.Form):
    username = forms.CharField(max_length=30, required=True)
    email = forms.EmailField(required=True)
    password = forms.CharField(widget=forms.PasswordInput, required=True)
  • username：最大限制 30 个字符。
  • email：验证是否为邮件格式。
  • password：输入是必须的，并使用密码输入字段。

1.2 数据验证流程

Django Forms 将验证完成的数据存储在 cleaned_data 中，并以字段名为键的字典格式返回。

  • 如果数据验证失败，错误消息将以字典形式存储在 form.errors 属性中。每个字段名为键，对应字段的错误消息为值。
  1. 用户输入数据并提交表单。
  2. Django 调用 is_valid() 方法进行数据验证。
  3. 如果数据有效，则保存到 cleaned_data 中，否则会添加错误消息。
数据验证流程示例
form = RegistrationForm(request.POST)
if form.is_valid():
    username = form.cleaned_data['username']
    email = form.cleaned_data['email']
    password = form.cleaned_data['password']
else:
    print(form.errors)  # 验证失败时输出错误

2. 字段单独验证自定义

2.1 clean_fieldname() 方法

要自定义特定字段的验证，需要定义 clean_fieldname() 方法。

示例：用户名称重复检查
class RegistrationForm(forms.Form):
    username = forms.CharField(max_length=30)

    def clean_username(self):
        username = self.cleaned_data['username']
        if username.lower() == 'admin':
            raise forms.ValidationError("'admin' 不能作为用户名。")
        return username

工作原理：clean_username() 方法检查 username 字段的验证性，如果有问题则抛出异常。

3. 表单整体验证

3.1 clean() 方法

当基于整个表单数据需要验证时，可以重写 clean() 方法。

示例：密码确认
class PasswordChangeForm(forms.Form):
    new_password = forms.CharField(widget=forms.PasswordInput)
    confirm_password = forms.CharField(widget=forms.PasswordInput)

    def clean(self):
        cleaned_data = super().clean()
        password = cleaned_data.get("new_password")
        confirm_password = cleaned_data.get("confirm_password")

        if password != confirm_password:
            raise forms.ValidationError("密码不一致。")

        return cleaned_data

用途: 当需要多字段之间的相互验证时使用。

4. 错误消息自定义

Django Forms 提供基本的错误消息。然而，为了用户友好，可以对其进行自定义。

4.1 修改字段错误消息

示例：为字段指定错误消息
class CustomErrorForm(forms.Form):
    email = forms.EmailField(
        error_messages={
            'required': "请输入电子邮件地址。",
            'invalid': "请输入有效的电子邮件地址。"
        }
    )

4.2 整体表单错误处理

示例：密码验证错误消息
class LoginForm(forms.Form):
    username = forms.CharField(max_length=30)
    password = forms.CharField(widget=forms.PasswordInput)

    def clean(self):
        cleaned_data = super().clean()
        username = cleaned_data.get('username')
        password = cleaned_data.get('password')

        # 添加用户认证逻辑
        if not authenticate(username=username, password=password):
            raise forms.ValidationError("用户名或密码错误。")

5. 实际案例：复杂验证

5.1 实现注册表单

表单定义
class SignupForm(forms.Form):
    username = forms.CharField(max_length=30)
    email = forms.EmailField()
    password = forms.CharField(widget=forms.PasswordInput)
    confirm_password = forms.CharField(widget=forms.PasswordInput)

    def clean_username(self):
        username = self.cleaned_data['username']
        if User.objects.filter(username=username).exists():
            raise forms.ValidationError("用户名已被使用。")
        return username

    def clean(self):
        cleaned_data = super().clean()
        password = cleaned_data.get('password')
        confirm_password = cleaned_data.get('confirm_password')

        if password != confirm_password:
            raise forms.ValidationError("密码不一致。")
        return cleaned_data
视图定义
from django.shortcuts import render, redirect
from .forms import SignupForm

def signup_view(request):
    if request.method == 'POST':
        form = SignupForm(request.POST)
        if form.is_valid():
            User.objects.create_user(
                username=form.cleaned_data['username'],
                email=form.cleaned_data['email'],
                password=form.cleaned_data['password']
            )
            return redirect('login')
    else:
        form = SignupForm()
    return render(request, 'signup.html', {'form': form})

6. 结论

Django Forms 的验证是增强数据输入的准确性和安全性的关键功能。除了基本提供的验证功能外，还可以根据项目需求自定义验证。下一篇文章将讨论 利用 Django Forms 和 CSS 进行表单样式设计。