如何基于Django DRF批量部分更新模型的order字段？

要实现批量传入id和order字段更新模型，你需要自定义处理批量请求的视图，配合专用序列化器验证输入数据。以下是具体实现方案：

1. 创建批量更新专用序列化器 #

这个序列化器仅关注id和order字段，同时验证id对应的模型实例是否存在：

from rest_framework import serializers
from .models import Waitlist

class WaitlistOrderUpdateSerializer(serializers.ModelSerializer):
    class Meta:
        model = Waitlist
        fields = ['id', 'order']
        extra_kwargs = {
            'id': {'required': True},
            'order': {'required': True}
        }

    def validate_id(self, value):
        if not Waitlist.objects.filter(id=value).exists():
            raise serializers.ValidationError(f"ID为{value}的Waitlist实例不存在")
        return value

2. 编写批量更新视图 #

继承APIView并重写put方法（符合REST更新操作规范），处理批量数据的验证与更新：

from rest_framework.views import APIView
from rest_framework.response import Response
from rest_framework import status
from .models import Waitlist
from .serializers import WaitlistOrderUpdateSerializer

class WaitlistBulkUpdateAPIView(APIView):
    def put(self, request, *args, **kwargs):
        # 验证请求数据是否为列表格式
        if not isinstance(request.data, list):
            return Response({"error": "请求数据必须为对象列表"}, status=status.HTTP_400_BAD_REQUEST)
        
        # 批量验证数据
        serializer = WaitlistOrderUpdateSerializer(data=request.data, many=True)
        if serializer.is_valid():
            # 收集需要更新的实例
            update_instances = []
            for item in serializer.validated_data:
                instance = Waitlist.objects.get(id=item['id'])
                instance.order = item['order']
                update_instances.append(instance)
            
            # 批量更新数据库，提升效率
            Waitlist.objects.bulk_update(update_instances, ['order'])
            return Response(serializer.data, status=status.HTTP_200_OK)
        
        return Response(serializer.errors, status=status.HTTP_400_BAD_REQUEST)

3. 配置路由 #

在项目的urls.py中添加批量更新的路由：

from django.urls import path
from .views import WaitlistBulkUpdateAPIView, WaitlistListGen, WaitlistDetailGen

urlpatterns = [
    path('waitlists/', WaitlistListGen.as_view(), name='waitlist-list'),
    path('waitlists/<int:pk>/', WaitlistDetailGen.as_view(), name='waitlist-detail'),
    path('waitlists/bulk-update/', WaitlistBulkUpdateAPIView.as_view(), name='waitlist-bulk-update'),
]

说明 #

• 原有的RetrieveUpdateDestroyAPIView仅支持单实例更新，无法处理批量数据，因此需要自定义视图。
• 使用bulk_update可以减少数据库查询次数，比逐个更新更高效。
• 专用序列化器确保了输入数据的合法性，避免不必要的字段被修改。

内容的提问来源于stack exchange，提问作者cbirch