序列化组件

定义序列化器

# 1）创建models.py文件(数据库模型类)
class Depart(models.Model):
    title = models.CharField(verbose_name='标题',max_length=32)
    count = models.IntegerField(verbose_name='人数')
# 2）在软件的文件夹下创建一个存放序列化器的py文件
from rest_framework import serializers
class DepartSerializer(serializers.Serializer):
    """图书数据序列化器"""
    id = serializers.IntegerField(label='ID',read_only=True)
    title = serializers.CharField(label='标题',max_length=20)
    count = serializers.IntegerField(label='人数')
# 3) 序列化器的使用
序列化器的使用分两个阶段：
	在客户端请求时，使用序列化器可以完成对数据的反序列化。
	在服务器响应时，使用序列化器可以完成对数据的序列化。
    
# views.py(视图层)
from rest_framework.views import APIView
from rest_framework.response import Response

class DepartView(APIView):
    def get(self,request, *args,**kwargs):
        depart_object = models.Depart.objects.all()
        ser = DepartSerializer(instance=depart_object,many=True)  
        # 多条数据用many=True参数补充说明
        return Response(ser.data)
    
    def put(self,request,pk):
        """全部更新"""
        depart_object = models.Depart.objects.filter(id=pk).first()
        if not depart_object:
            return Response('数据不存在，无法更新')

        ser = DepartSerializer(instance=depart_object)
        if ser.is_valid():   
        # 在获取反序列化的数据前，必须调用is_valid()方法进行验证，验证成功返回True，否则返回False。
            ser.save()
            return Response('成功')
        else:
            return Response('验证失败')
        
"""
注：ser.errors  可以通过序列化器对象的errors属性获取错误信息
"""

模型类序列化器

"""
如果我们想要使用序列化器对应的是Django的模型类，DRF为我们提供了ModelSerializer模型类序列化器来帮助我们快速创建一个Serializer类。

ModelSerializer与常规的Serializer相同，但提供了：

    基于模型类自动生成一系列字段
    基于模型类自动为Serializer生成validators，比如unique_together
    包含默认的create()和update()的实现
"""

class DepartSerializer(serializers.ModelSerializer):
    class Meta:
        model = models.Depart
        fields = "__all__"
# model 指明参照哪个模型类
# fields 指明为模型类的那些字段生成

__all__:表名包含所有字段，也可以写明具体哪些字段
exclude = ('count',)  # 使用exclude可以明确排除掉哪些字段
fields = ('id', 'title',)  # 显示指明字段
read_only_fields = ('id',) # read_only_fields指明只读字段，即仅用于序列化输出的字段
extra_kwargs = {
            'comment': {'min_value': 0, 'required': True},
        }
# extra_kwargs参数为ModelSerializer添加或修改原有的选项参数