Django 验证：当必填字段缺失时，Django 依然调用 clean()

在本文中，我们将介绍 Django 验证的一个特性：当表单中的必填字段缺失时，Django 依然会调用字段的 clean() 方法。

阅读更多：Django 教程

Django 表单验证简介

在 Django 中，表单验证是一个重要的组成部分。它允许我们在后端对用户提交的数据进行验证和处理，确保数据的有效性和完整性。Django 提供了强大的验证工具，如字段验证、表单验证和模型验证等。

清理字段值：clean() 方法

Django 表单中的字段有一个名为 clean() 的方法。该方法用于对字段的值进行清理和验证，并返回清理后的值。当表单提交时，Django 会自动调用字段的 clean() 方法。

clean() 方法通常用于验证字段的值，确保其符合特定的要求，比如长度、格式、唯一性等。如果字段的值不符合要求，可以通过引发 ValidationError 来指示错误。

必填字段缺失的情况

在 Django 中，我们可以通过将字段的 required 参数设置为 True 来指定该字段为必填字段。当用户提交表单时，如果必填字段缺失，Django 会自动引发一个 ValidationError。

然而，一个有趣的现象是，即使必填字段缺失，Django 依然会调用字段的 clean() 方法。这意味着，即使我们没有输入任何值，clean() 方法也会得到调用。

下面是一个示例：

from django import forms

class MyForm(forms.Form):
    username = forms.CharField(label='用户名', max_length=100, required=True)

    def clean_username(self):
        username = self.cleaned_data.get('username')

        if not username:
            raise forms.ValidationError('请输入用户名')

        return username

在上面的示例中，我们定义了一个表单 MyForm，其中包含一个必填字段 username。在 clean_username() 方法中，我们对字段的值进行验证，如果值为空，就引发一个 ValidationError。

当我们提交一个空的表单时，Django 会引发 ValidationError，错误消息为 “请输入用户名”。这表明 clean() 方法会被调用，即使字段缺失。

clean() 方法的调用时机

为什么 Django 在必填字段缺失的情况下还要调用 clean() 方法呢？原因是为了保持一致性和灵活性。

Django 的表单验证工作流程是这样的：

1. 用户提交表单；
2. Django 获取表单数据，并按字段定义进行初始化；
3. Django 逐个字段进行验证，在验证过程中调用字段的 clean() 方法。

在这个过程中，Django 并不知道哪些字段是必填字段，它只负责验证字段的有效性和完整性。为了保持一致性，Django 在调用字段的 clean() 方法时不会判断字段是否为必填字段。

这样的设计也给开发者带来了灵活性。假设我们需要在 clean() 方法中对字段进行一些额外的处理，比如对字段进行转换、格式化、合并等操作，那么即使字段是必填字段，我们也可以在 clean() 方法中进行这些操作。

总结

在本文中，我们介绍了 Django 的一个特性：当必填字段缺失时，Django 依然会调用字段的 clean() 方法。我们了解到，这是为了保持一致性和灵活性。虽然这个特性可能看起来有点奇怪，但它确实为我们提供了更多的自由度来处理表单验证和字段清理的逻辑。

通过学习 Django 表单验证的这一特性，我们可以更好地理解 Django 的工作原理，并在开发过程中更加灵活地处理表单验证的需求。

希望本文能够帮助你更好地理解 Django 表单验证中的 clean() 方法，并应用到你的开发实践中。谢谢阅读！