Django ModelSerializer 实现自定义验证详解

随着 Web 开发的日益复杂化，对数据验证的需求也日益增加。Django REST framework 提供了一套强大的、灵活的验证系统，帮助开发者轻松处理各种复杂情况。本文将重点探讨 Django ModelSerializer 中如何实现自定义验证。

1. 简介

Django ModelSerializer 不仅简化了序列化过程，还内建了多种字段验证器，帮助开发者确保数据的完整性和准确性。但在某些场景下，我们需要进一步自定义验证逻辑。以下将通过示例代码详细说明。

2. 自定义验证方法

你可以通过在 ModelSerializer 子类中添加以 validate_ 开头的方法来实现字段级别的自定义验证。例如：

from rest_framework import serializers
from .models import MyModel

class MyModelSerializer(serializers.ModelSerializer):
    class Meta:
        model = MyModel
        fields = ['name', 'email']

    def validate_name(self, value):
        """
        自定义名称验证
        """
        if 'admin' in value.lower():
            raise serializers.ValidationError("名称中不能包含 'admin'")
        return value

在上面的示例中，我们定义了一个 validate_name 方法来确保模型的 name 字段中不包含 'admin' 字符串。

3. 全局自定义验证

除了字段级别的验证外，我们还可以对多个字段进行整体验证。这可以通过覆写 ModelSerializer 的 validate 方法实现。例如：

class MyModelSerializer(serializers.ModelSerializer):
    class Meta:
        model = MyModel
        fields = ['name', 'email']

    def validate(self, data):
        """
        自定义全局验证
        """
        name = data['name']
        email = data['email']
        if 'admin' in name.lower() and 'admin' in email.lower():
            raise serializers.ValidationError("名称和邮箱中不能同时包含 'admin'")
        return data

这里的 validate 方法会在所有字段级别验证完成后执行，允许我们进行更复杂的逻辑判断。

4. 使用自定义验证器

有时，我们可能需要抽象出更复杂的验证逻辑。这时，可以创建自定义的验证器类。例如：

from rest_framework import serializers

class NoAdminValidator:
    def __call__(self, value):
        if 'admin' in value.lower():
            message = "值中不能包含 'admin'"
            raise serializers.ValidationError(message)

class MyModelSerializer(serializers.ModelSerializer):
    name = serializers.CharField(validators=[NoAdminValidator()])
    
    class Meta:
        model = MyModel
        fields = ['name', 'email']

这里，我们创建了一个 NoAdminValidator 验证器，并将其添加到 name 字段的 validators 参数中。