DRF框架之serializer序列化

# 序列化与反序列化

# 1.序列化

概念：将程序中的一个数据结构类型转化为其它格式（字典、json、XML等）。例如：将 django 中的模型类对象转换为json字符串，这个转换过程称之为序列化 序列化时机：当需要给前端响应模型数据时，需要将模型数据序列化成前端需要的格式

# 2.反序列化

概念：将其它格式（字典、json、XML等）转换为程序中的数据，例如：将json字符串转换为 django 中的模型类对象，这个过程称之为反序列化 反序列化时机：当需要将用户发送的数据存储到数据库之前，需要使用反序列化

# 3.开发Restful接口

视图中做的最主要的三件事：

将请求的数据（如：Json格式）转换为模型类对象（反序列化)
操作数据库
将模型类对象转换为响应的数据（如：Json格式）（序列化）

在视图中需要做的最核心的事：

将数据库数据序列化为前端所需要的格式，并返回
将前端发送的数据反序列化为模型类对象，并保存到数据库中

# 常用序列化器类

# 1.serializers.Serializer

应用下先创建一个名为 serializers.py 的模块，在该模块下需要引入 serializers 模块，并创建序列化器类 ProjectsSerializer 继承 serializers.Serializer 父类

from rest_framework import serializers
class ProjectSerializer(serializers.Serializer):
    name = serializers.CharField(max_length=200, label="项目名称", help_text='项目名称')
    leader = serializers.CharField(max_length=50, label="项目负责人"， help_text='项目负责人')
    programmer = serializers.CharField(max_length=50, label="开发人员", help_text="开发人员")
    tester = serializers.CharField(max_length=50, label="测试人员", help_text="测试人员")

# 字段说明

max_length：最大长度：在反序列化时进行输入最大长度校验
min_length ：最小长度：在反序列化时进行输入最小长度校验
allow_blank：是否允许为空：在反序列化时允许传空白字符串，默认不允许
max_value：最大值：在反序列化时进行输入最大值校验
min_value：最小值：在反序列化时进行输入最小值校验
read_only：表明该字段仅用于序列化输出，但在反序列化验证时不做校验，默认 False
write_only：表明该字段仅用于反序列化输入，但在序列化时不进行输出，默认 False
required：表明该字段在反序列化时必须输入，序列化时必须输出，默认 True
default：反序列化时使用的默认值，如果不指明，在传递时默认值为 0
allow_null：表明该字段是否允许传入 None，默认 False
validators ：该字段使用的验证器
error_messages：包含错误编号与错误信息的字典
label：用于HTML展示API页面时，显示的字段名称，相当于模型类字段的 verbose_name 属性
help_text：用于HTML展示API页面时，显示的字段帮助提示信息

# 序列化模型类对象

在视图类模块下，返回的为模型类对象时，使用步骤如下：

实例化一个序列化器类，将模型类对象传给 instance 变量，并返回一个序列化器类对象
调用序列化器类对象的 data 属性后传入 JsonResponse 并 return

obj = Projects.objects.get(id__exact=pk)
serializer_obj = ProjectSerializer(instance=obj)
return JsonResponse(serializer_obj.data)

# 序列化查询集

在视图类模块下，返回的为查询集时，使用步骤如下：

实例化一个序列化器类，将模型类对象传给 instance 变量，并且设置 many=True，并返回一个序列化器类对象
调用序列化器类对象的 data 属性后传入 JsonResponse ，设置 safe=False ，并 return

# 自定义create和update方法

def create(self, validated_data):
    # validated_data参数为校验通过之后的数据
    # 必须将创建成功的模型类对象返回
    obj = Projects.objects.create(**validated_data)
    return obj

def update(self, instance, validated_data):
    # instance为待更新的模型类对象
    # validated_data参数为校验通过之后的数据
    # 必须将更新成功的模型类对象返回
    instance.name = validated_data.get('name') or instance.name
    instance.leader = validated_data.get('leader') or instance.leader
    instance.tester = validated_data.get('tester') or instance.tester
    instance.programmer = validated_data.get('programmer') or instance.programmer
    instance.desc = validated_data.get('desc') or instance.desc
    instance.save()
    return instance

# 2.serializers.ModelSerializer

应用下先创建一个名为 serializers.py 的模块，在该模块下需要引入 serializers 模块，并创建序列化器类 ProjectsModelSerializer 继承 serializers.ModelSerializer 父类

# 特性

filed 字段可以不需要自己写，与模型一一对应
ModelSerializer 中定义了与本来需要序列化字段同名的字段，会覆盖原来的模型类映射的字段
简单的实现了 create 和 update 方法，可根据需求重写。调用父类的 creat 和 update 方法时，validated_data 不需要解包
```
# update
super().update(instance, validated_data)
# create
super().create(validated_data)
```

# 自定义Meta参数属性

mode关联的模型类
fields：
- 使用 fields 来明确字段, 可以写明具体哪些字段
- 也可以写 __all__，所有字段都生成序列化规则
exclude：可以明确排除掉哪些字段
read_only_fields：指明只读字段,即仅用于序列化输出的字段
extra_kwargs：为 ModelSerializer 添加或修改原有的选项参数，来定制某些字段（嵌套字典）

from rest_framework import serializers
from App.models import Projects

class ProjectModelSerializer(serializers.ModelSerializer):
    email = serializers.EmailField(write_only=True)
    
    class Meta:
        # 需要在Meta内部类这两个指定model类属性：需要按照哪一个模型类来创建
        # fields类属性来指定模型类中哪些字段需要输入或输出
        model = Projects
        fields = '__all__'
        exclude = ('id', 'desc', 'create_time')
        extra_kwargs = {
            'programmer': {
                'label': '研发人员',
                'write_only': True,
            }
        }

汽水味的夏天