1. 验证

• 使用序列化器进行反序列化时,需要对数据进行验证后,才能获取验证成功的数据或保存成模型类对象
• 在获取反序列化的数据前,必须调用is_valid()方法进行验证,验证成功返回True,否则返回False
• 验证失败: 可以通过序列化器对象的errors属性获取错误信息,返回字典,包含了字段和字段的错误
• 验证成功: 可以通过序列化器对象的validated_data属性获取数据

测试用例

# 班级类用例
class ClassInfoSerializer(serializers.Serializer)
    name = serializers.CharField(label='班级名称', max_length=20)
    Info = serializers.CharField(label='班级信息', max_length=20)

下面将通过构造序列化器对象,并将要反序列化的数据传递给data构造参数,进而进行验证:

1. 验证失败的例子

data =  {'name': 123}
serializer = ClassInfoSerializer(data=data)
serializer.is_valid()  # 返回False
# {'btitle': [ErrorDetail(string='This field is required.', code='required')], 'name': [ErrorDetail(string='Date has wrong format. Use one of these formats instead: YYYY[-MM[-DD]].', code='invalid')]}
print(serializer.validated_data)  # {} 验证失败就是空

2. 验证成功的例子

data = {'name': 'python'}
serializer = ClassInfoSerializer(data=data)
serializer.is_valid()  # True
serializer.errors  # {} 验证成功没有错误信息
print(serializer.validated_data)  #  OrderedDict([('name', 'python')])

2. 自定义验证行为:验证过程中可以对数据为所欲为

validate_<field_name>

• 比如想校验一个字段是否包含某个逻辑

# 班级类用例
class ClassInfoSerializer(serializers.Serializer)
    name = serializers.CharField(label='班级名称', max_length=20)
    Info = serializers.CharField(label='班级信息', max_length=20)

    # 对info字段进行单独校验
    def validate_info(self, value):  # value 就是传进来的info的值
        if 'shanghaidaxue' not in value: 
            raise serializers.ValidationError("上海大学没有这个班级")
        #中间可以对信息为所欲为的操作
        value += '这个是上海大学的班级'
        return value

validate

• validate发生在validate_<field_name>之后,是校验数据的最后一步,中间是对整个数据集的校验
• 一次可以对多个字段进行校验

# 班级类用例
class ClassInfoSerializer(serializers.Serializer)
    name = serializers.CharField(label='班级名称', max_length=20)
    Info = serializers.CharField(label='班级信息', max_length=20)

    def validate(self, attr):  # attr 代表所有的传进来的值,里面是一个字典
        #中间对数据为所欲为
        attr['name'] += '姓名已经校验过了'
        attr['info'] += '信息符合规范'

        return attr

validators:自定义校验

• 在字段中添加validators选项参数,也可以补充验证行为

def about_class(value):
    if 'shanghaidaxue' not in value: 
        raise serializers.ValidationError("上海大学没有这个班级")
# 班级类用例
class ClassInfoSerializer(serializers.Serializer)
    name = serializers.CharField(label='班级名称', max_length=20)
    #给字段添加自定义的校验参数
    Info = serializers.CharField(label='班级信息', max_length=20, validators=[about_class])

3. 保存信息

• 如果在验证成功后,想要基于validated_data完成数据对象的创建,可以通过实现create()和update()两个方法来实现
• 序列化器内部会根据有无传入instance(数据库对象) 来判定是创建数据还是更新数据,如果传入instance就代表需要更新 反之

# 构造序列化器
class ClassInfoSerializer(serializers.Serializer)
    name = serializers.CharField(label='班级名称', max_length=20)
    Info = serializers.CharField(label='班级信息', max_length=20)
    
    # 重写创建方法
    def create(self, validated_data) #validated_data是已经校验过的数据
        instance = ClassInfo.objects.create(**validated_data) # 在数据库创建数据 并返回一个数据库对象
        return instance

    # 重写更新方法
    def update(self, instance, validated_data):# instance 是传进来的数据库对象,是要更新的对象
        instance.name = validated_data.get('name', instance.name)#得到validated_data中的name信息
        instance.info = validated_data.get('info', instance.info)#如果得不到则使用instance中的name
        return instance

实现了上面两个方法后,当更新数据 或者创建数据的时候就能返回一个数据库对象了

# 构造一个数据
data = { name:'九年级三班', info:'上海大学九年级三班'}

# 创建数据
class3 = ClassInfoSerializer(data)# 得到一个序列化器对象
class3.is_valid()
classinstance = class3.save()  # classinstance此时就是一个数据库的对象

# 更新数据
data = {  name:'九年级3班'} #只更新 name字段,因为 info不是必传的
classserializer = ClassInfoSerializer(classinstance, data)# 得到序列化器对象
classserializer.is_valid()

classinstance = classserializer.save() #序列化器保存时 调用重写的update方法 并返回一个更新后的数据库对象