DRF框架(四)——单整体改(put)、单局部改(patch)、群局部改(patch)--ListSerializer

单整体改   单指的是单独一条数据，整体指这条数据的设置不为空字段都必须传值修改

基于上篇文章的代码修改，序列化层不用变，只修改views.py

1)单整体改，说明前台要提供修改的数据，修改之后保存的数据需要校验，校验的数据应该在实例化“序列化类对象”时，赋值给data
2）修改，就必须明确被修改的模型类对象，并在实例化“序列化类对象”时，赋值给instance，必须赋值给instance
3）整体修改，所有校验规则有required=True的字段，都必须提供，因为在实例化“序列化类对象”时，参数partial默认为False

注：如果partial值设置为True，就是可以局部改
1）单整体修改，一般用put请求：
V2BookModelSerializer(
    instance=要被更新的对象, 
    data=用来更新的数据,
    partial=默认False，必须的字段全部参与校验
)
2）单局部修改，一般用patch请求：
V2BookModelSerializer(
    instance=要被更新的对象, 
    data=用来更新的数据,
    partial=设置True，必须的字段都变为选填字段
)
    注：partial设置True的本质就是使字段 required=True 校验规则失效

 

请求方法：put   整体修改
请求参数：pk从路由传参，修改的数据通过数据包json传递
请求接口： http://127.0.0.1:8080/app01/v3/books/pk/

视图层：views.py

#单整体改  对 v3/books/pk/  传的参数是与model对应的字典 {name|price|publish|authors}在json中传递
class V3Book(APIView):
    def put(self,request,*args,**kwargs):
        request_data = request.data
        pk = kwargs.get('pk')
        #先获取要修改的对象
        try:
            old_book_obj = models.Book.objects.get(pk=pk,is_delete=False)
        except:
            #当输入不存在的pk
            return Response({
                'status':1,
                'msg':'参数错误'
            })
        book_ser = serializers.V2BookModelSerializer(instance=old_book_obj,data=request_data,partial=False)
        book_ser.is_valid(raise_exception=True)
        book_obj = book_ser.save()

        return Response({
            'status':0,
            'msg':'ok',
            'results':serializers.V2BookModelSerializer(book_obj).data
        })

单整体修改注意点（******）

1.需要修改的数据通过data传递
2.需要修改的模型类对象必须传递给instance
3.参数partial设置为False (默认是False,这里不设置也行)

单局部修改

单整体修改和单局部修改只有一点不相同：

设置参数partial=True，就变成单局部修改，修改的参数就不必全部传，想修改什么数据就传什么数据

单局部修改和群局部修改整合      ListSerializer辅助（群增，群改）

当一个序列化器在带有many=True选项被序列化时，将创建一个ListSerializer实例，该序列化器类将成为ListSerializer类的子类。
当你需要自定义多个对象的行为时（比如群增，群改）,你需要手动定制ListSerializer类的一些行为。
可以通过在自定义序列化器的Meta类下面的list_serializer_class来绑定你需要的的ListSerializer类

序列化层 serializer.py

群改需要设置ListSerializer，创建V2BookListSerializer继承ListSerializer,重写update方法

# 重点：ListSerializer与ModelSerializer建立关联的是： 在ModelSerializer的Meta类中设置   list_serializer_class
class V2BookListSerializer(ListSerializer):   
　　def update(self, instance, validated_data):  # print(instance)  # 要更新的对象们
        # print(validated_data)  # 更新的对象对应的数据们
        # print(self.child)  # 服务的模型序列化类 - V2BookModelSerializer
        for index, obj in enumerate(instance):
            self.child.update(obj, validated_data[index])
        return instance
    
# 原模型序列化类变化
class V2BookModelSerializer(ModelSerializer):
    class Meta:
        # 群改，list_serializer_class是固定的key写法，直接转入V2BookListSerializer类的 update 方法
        list_serializer_class = V2BookListSerializer

update方法源码分析： update方法里面没写东西

群增不需要重写create方法，因为源码中ListSerializer走的就是ModelSerializer的create方法 

create方法源码分析：

群局部修改

请求方式：patch
请求参数：
　　单局部修改： v3/books/pk/  pk通过路由传参，修改数据通过json传参
　　群局部修改： v3/books/ 修改的数据都是从json传递   eg:[{'pk':1,'name':'花果山'}，{'pk':2,'price':3.33}]
请求接口：http://127.0.0.1:8080/app01/v3/books/pk/

视图层:views.py

 #单局部改和群局部改整合
    #单局部改：对 v3/books/pk/   pk通过路由传参，修改数据选择传参，通过数据包json传递
    #群局部修改：v3/books/ 修改数据通过数据包传递，设置成列表格式  [{pk:1,name:123},{pk:3,price:7},{pk:7,publish:2}]
    def patch(self,request,*args,**kwargs):
        request_data = request.data  #数据包数据
        pk = kwargs.get('pk')
        # 将单改，群改的数据都格式化成 pks=[要需要的对象主键标识] | request_data=[每个要修改的对象对应的修改数据]
        if pk and isinstance(request_data,dict):  #单改
            pks = [pk,]
            request_data = [request_data,]
        elif not pk and isinstance(request_data,list):  #群改
            pks = []
            # 遍历前台数据[{pk:1, name:123}, {pk:3, price:7}, {pk:7, publish:2}]，拿一个个字典
            for dic in request_data:
                pk=dic.pop('pk',None)  #返回pk值
                if pk:
                    pks.append(pk)
                #pk没有传值
                else:
                    return Response({
                        'status':1,
                        'msg':'参数错误'
                    })
        else:
            return Response({
                'status': 1,
                'msg': '参数错误'
            })
        # pks与request_data数据筛选，
        # 1）将pks中的没有对应数据的pk与数据已删除的pk移除，request_data对应索引位上的数据也移除
        # 2）将合理的pks转换为 objs
        objs = []
        new_request_data = []
        for index,pk in enumerate(pks):
            try:
                #将pk合理的对象数据保存下来
                book_obj = models.Book.objects.get(pk=pk,is_delete=False)
                objs.append(book_obj)
                #对应索引的数据也保存下来
                new_request_data.append(request_data[index])
            except:
                # 重点：反面教程 - pk对应的数据有误，将对应索引的data中request_data中移除
                #在for循环中不要使用删除
                # index = pks.index(pk)
                # request_data.pop(index)
                continue
        #生成一个serializer对象
        book_ser = serializers.V2BookModelSerializer(instance=objs,data=new_request_data,partial=True,many=True)
        book_ser.is_valid(raise_exception=True)
        book_objs = book_ser.save()


        return Response({
            'status':0,
            'msg':'ok',
            'results':serializers.V2BookModelSerializer(book_objs,many=True).data
        })

思路：

1.先将单改，群改的数据都格式化成 pks=[要需要的对象主键标识] | request_data=[每个要修改的对象对应的修改数据]
2.pks与request_data数据筛选，
      将pks中的没有对应数据的pk与数据已删除的pk移除，request_data对应索引位上的数据也移除
       将合理的pks转换为 objs

 注意点：

1.本篇文章讲了局部修改patch,和整体修改put,都需要设置参数instance传入的是要修改的对象，data传入的是修改的数据
2.群修改的话需要使用ListSerializer,重写update方法

关于使用修改为什么要用instance传参 （源码分析）

修改之后数据使用save()保存，从视图的save()点击进去查看源码，下面是BaseSerializer类中的save

在这判断是否有instance属性

有的话就走update()方法，所以我们在做修改（put,patch）的时候就要传入instance。    没有的话就走create(),创建一条新数据

 

源码中发现：如果你使用的是Serializer,在视图使用save方法保存数据，但是通过源码发现Serializer类中没有save方法所以只能从他继承的BaseSerializer中走save方法。你使用的是ModelSerializer,因为ModelSerializer类中没有save方法，只能去他继承的Serializer类中找save方法，Serializer类中也没有save方法，所以最后不管你用的是Serializer还是ModelSerializer都要去BaseSerializer中找save方法。然后从save方法中去实现update和create方法。

拓展：

顺带提一嘴，在BaseSerializer中的update和create方法都是不起作用的，从下面源码可以看出，所以如果你的Serializer类是走的BaseSerializer的update和create方法，那么你就必须在你的Serializer类中重写update和create方法

 

因为ModelSeerializer中有create和update方法，而且都是有用的，所以在ModelSeerializer中不需要重写create和update方法