Django 在 Django 中使用 cleaned_data 的方法

在本文中，我们将介绍在 Django 中如何使用 cleaned_data 来处理表单数据。Django 是一个流行的 Python Web 开发框架，提供了强大的表单处理功能。通过使用 cleaned_data，我们可以轻松地验证和清理用户提交的数据，从而确保数据的安全性和一致性。

阅读更多：Django 教程

表单验证与数据清理

表单验证是 Web 应用程序开发中的重要环节之一。当用户提交表单时，我们需要验证输入的数据是否符合预期的格式和规则，并对不符合要求的数据进行清理和修正。Django 提供了一种方便的方式来实现这些功能，即使用表单类。

以下是一个简单的例子，展示了如何在 Django 中定义一个表单类并使用 cleaned_data 对数据进行验证和清理：

from django import forms

class LoginForm(forms.Form):
    username = forms.CharField(label='用户名', max_length=100)
    password = forms.CharField(label='密码', widget=forms.PasswordInput)

    def clean_username(self):
        username = self.cleaned_data.get('username')
        if not username:
            raise forms.ValidationError('用户名不能为空')
        return username

    def clean_password(self):
        password = self.cleaned_data.get('password')
        if not password:
            raise forms.ValidationError('密码不能为空')
        return password

在上述代码中，我们定义了一个登录表单类 LoginForm，它包含了两个字段：username 和 password。我们分别为这两个字段定义了验证规则，即 clean_username 和 clean_password 方法。在这两个方法中，我们可以使用 self.cleaned_data 来访问到表单中的数据，并对其进行验证和清理。

validated_data 和 cleaned_data

在 Django 中，我们可以使用 self.cleaned_data 来获取验证通过并清理后的数据。当表单数据通过验证后，self.cleaned_data 将包含一个字典，其中包含了经过验证和清理后的每个字段的数据。

以下是一个示例程序，展示了如何使用 cleaned_data 来处理表单数据：

def login(request):
    if request.method == 'POST':
        form = LoginForm(request.POST)
        if form.is_valid():
            username = form.cleaned_data['username']
            password = form.cleaned_data['password']
            # 处理登录逻辑
            return redirect('home')
    else:
        form = LoginForm()
    return render(request, 'login.html', {'form': form})

在上述示例中，我们首先通过 request.POST 来创建 LoginForm 的实例。然后，我们使用 is_valid() 方法来验证表单数据是否有效。如果表单数据有效，我们可以使用 form.cleaned_data 来获取验证通过后的数据。在这个例子中，我们获取了登录表单中的 username 和 password 字段的值，并使用其进行登录逻辑的处理。

自定义清理方法和清理顺序

除了使用 clean 开头的方法进行单个字段的验证和清理外，我们还可以在表单类中定义一个 clean 方法，来对整个表单数据进行验证和清理。

下面的代码展示了一个自定义的 clean 方法的示例：

class RegistrationForm(forms.Form):
    username = forms.CharField(label='用户名', max_length=100)
    password = forms.CharField(label='密码', widget=forms.PasswordInput)
    confirm_password = forms.CharField(label='确认密码', widget=forms.PasswordInput)

    def clean(self):
        cleaned_data = super().clean()
        password = cleaned_data.get('password')
        confirm_password = cleaned_data.get('confirm_password')
        if password and confirm_password and password != confirm_password:
            raise forms.ValidationError('两次密码输入不一致')

在上述示例中，我们定义了一个注册表单类 RegistrationForm，它包含了 username、password 和 confirm_password 这三个字段。我们通过定义一个 clean 方法，来对整个表单数据进行验证和清理。在 clean 方法中，我们首先调用父类的 clean 方法获取到所有字段的清理后的数据，然后我们进一步验证密码和确认密码是否一致。

需要注意的是，默认情况下，clean 方法的调用顺序与表单类中字段的声明顺序一致。如果需要改变字段的清理顺序，我们可以在表单类中使用 field_order 属性来指定字段的清理顺序。

总结

本文介绍了在 Django 中使用 cleaned_data 来处理表单数据的方法。通过表单类的验证规则和清理方法，我们可以轻松地对用户提交的数据进行验证和清理，从而保证数据的准确性和安全性。同时，我们还了解了如何使用 cleaned_data 来获取验证通过后的数据，并在示例代码中展示了如何处理登录和注册的功能。希望本文能够帮助你更好地理解和使用 Django 中的表单处理功能。