序列化组件

介绍

# 作用：
1. 序列化,序列化器（类）会把模型对象（Book对象，Queryset对象）转换成字典,经过response以后变成json字符串
2. 反序列化,把客户端发送过来的数据,经过request以后变成字典（request.data）,序列化器(类)可以把字典转成模型
3. 反序列化,完成数据校验功能

# Django REST framework中的Serializer使用类来定义，须继rest_framework.serializers.Serializer

使用

序列化类
from rest_framework import serializers
from .models import Books
class BookSerializer(serializers.Serializer):
    #写字段（要序列化，反序列化的字段）
    name=serializers.CharField()
    price=serializers.IntegerField()
    publish=serializers.CharField()

    # 如果要更新，一定要重写update方法
    def update(self, instance, validated_data):
        # 修改
        instance.name=validated_data.get('name')
        instance.price=validated_data.get('price')
        instance.publish=validated_data.get('publish')
        # 保存
        instance.save()
        # 返回
        return instance


    # 如果要新增，一定要重写create方法
    def create(self, validated_data):
        # 保存
        book=Books.objects.create(**validated_data)
        # 一定记得return
        return book
    
视图类
from rest_framework.views import APIView
from rest_framework.response import Response
from .models import Books
from rest_framework.request import Request
from .serizlizer import BookSerializer
class BookAPIView(APIView):
    #查询所有接口
    def get(self, request, *args, **kwargs):

        book_list=Books.objects.all()
        # 序列化过程，把queryset转成字典
        # 第一个参数是要序列化的对象,如果序列化多条数据，一定要加上many=True
        ser=BookSerializer(instance=book_list,many=True)
        print(ser.data)
        return Response(ser.data)


    def post(self, request, *args, **kwargs):

        ser=BookSerializer(data=request.data) #新增，不用传instance
        if ser.is_valid():
            ser.save()
            return Response(ser.data)

# 查询单个接口
class BookDetailAPIView(APIView):
    # 查询单个
    def get(self, request, pk):

        book = Books.objects.filter(pk=pk).first()
        # 序列化过程，把Book转成字典
        # 第一个参数是要序列化的对象,如果序列化多条数据
        ser = BookSerializer(instance=book)
        print(ser.data)
        return Response(ser.data)


    def delete(self,request,pk):
        Books.objects.filter(pk=pk).delete()
        return Response()

    def put(self,request,pk):

        book=Books.objects.filter(pk=pk).first()
        # 反序列化，修改
        # instance 传要修改的对象
        ser=BookSerializer(instance=book,data=request.data)  #修改
        # 校验数据
        if ser.is_valid():
            ser.save() # 报错
            return Response(ser.data)

反序列化

数据验证

使用序列化器进行反序列化时，需要对数据进行验证后，才能获取验证成功的数据或保存成模型类对象。

在获取反序列化的数据前，必须调用is_valid()方法进行验证，验证成功返回True，否则返回False。

验证失败，可以通过序列化器对象的errors属性获取错误信息，返回字典，包含了字段和字段的错误。如果是非字段错误，可以通过修改REST framework配置中的NON_FIELD_ERRORS_KEY来控制错误字典中的键名。

验证成功，可以通过序列化器对象的validated_data属性获取数据。

在定义序列化器时，指明每个字段的序列化类型和选项参数，本身就是一种验证行为。

Serializer高级使用

1. source 字段的作用
	-book_name=serializers.CharField(source="name")
    -source 可以对应表模型的字段和方法（返回结果是什么，字段就是什么）,表模型中写的方法
    -一般用来做一对多，多对多的字段返回
    
2. SerializerMethodField
	-使用方法如下
     publish=serializers.SerializerMethodField()
     def get_publish(self,obj):
        return {'name':obj.publish.name,'addr':obj.publish.addr}
    
3. 字段自己的校验规则
	-name=serializers.CharField(max_length=8,min_length=3)
4. 局部钩子
	def validate_name(self,name):
        if name.startswith('sb'):
            raise ValidationError('不能以sb开头')
        else:
            return name

5. 全局钩子
	   def validate(self, attrs):
            name=attrs.get('name')
            print(name)
            addr=attrs.get('addr')
            print(addr)
            return attrs

模型类序列化器

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

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

  • 基于模型类自动生成一系列字段
  • 基于模型类自动为Serializer生成validators，比如unique_together
  • 包含默认的create()和update()的实现
1 继承ModelSerializer
	-class PublishModelSerializer(serializers.ModelSerializer):
2 字段是通过表模型映射过来的
	class Meta:
        model=Publish  #表模型
        fields='__all__' # 序列化的字段
        # exclude=['id','name'] #排除的字段
        # depth    # 深度，一般不用
3 可以重写字段
	name = serializers.SerializerMethodField()
    def get_name(self, obj):
         return '著名出版社：' + obj.name
        
4 可以扩写字段（表模型中没有的字段）

5 反序列化时，字段自己的校验规则，映射了表模型的
6 局部钩子和全局钩子完全一样



7 wirte_only和read_only
    # 反序列化时候使用，  序列化时候不用
    # name=serializers.CharField(write_only=True)

    # 序列化的时候使用，反序列化不用
    # name=serializers.CharField(read_only=True)
    
8 extra_kwargs
		# 额外给字段传递参数，类似于
        # name = serializers.CharField(write_only=True,'max_length':8)
        extra_kwargs={'name':{'write_only':True,'max_length':8}}