餐厅Django REST API的CRUD实现咨询：请求响应与模型处理

刚好做过类似的餐厅API项目，结合你给出的Table模型，我来给你梳理下怎么实现不同请求的返回逻辑，保证GET请求返回模型对象，更新/删除请求返回清晰的反馈信息：

首先先补全你的Table模型（给它加个__str__方法，方便调试和后台显示）：

# models.py
class Table(models.Model):
    id = models.AutoField(primary_key=True)
    name = models.CharField(max_length=30, null=False, blank=False)
    is_free = models.BooleanField(default=True)

    def __str__(self):
        return self.name

第一步：创建序列化器 #

序列化器是Django REST API里连接模型和API响应的核心，我们创建一个TableSerializer来处理模型对象的序列化和反序列化：

# serializers.py
from rest_framework import serializers
from .models import Table

class TableSerializer(serializers.ModelSerializer):
    class Meta:
        model = Table
        fields = '__all__'  # 序列化所有字段，也可以指定具体字段比如['id', 'name', 'is_free']

第二步：编写视图处理不同请求 #

这里分两种方式给你示例：函数视图和类视图，你可以根据项目复杂度选择。

方式一：函数视图（简单直观，适合小型项目） #

# views.py
from rest_framework.response import Response
from rest_framework.decorators import api_view
from rest_framework import status
from .models import Table
from .serializers import TableSerializer

# 获取所有餐桌/单个餐桌 - 返回模型对象
@api_view(['GET'])
def table_list_or_detail(request, pk=None):
    if pk:
        # 获取单个餐桌
        try:
            table = Table.objects.get(pk=pk)
            serializer = TableSerializer(table)
            return Response(serializer.data)
        except Table.DoesNotExist:
            return Response({"error": "指定餐桌不存在"}, status=status.HTTP_404_NOT_FOUND)
    # 获取所有餐桌
    tables = Table.objects.all()
    serializer = TableSerializer(tables, many=True)
    return Response(serializer.data)

# 更新餐桌信息 - 返回反馈+更新后的模型对象
@api_view(['PUT', 'PATCH'])
def update_table(request, pk):
    try:
        table = Table.objects.get(pk=pk)
        # partial=True支持部分字段更新（比如只改is_free状态）
        serializer = TableSerializer(table, data=request.data, partial=True)
        if serializer.is_valid():
            serializer.save()
            return Response({
                "message": "餐桌信息更新成功",
                "updated_table": serializer.data
            }, status=status.HTTP_200_OK)
        return Response(serializer.errors, status=status.HTTP_400_BAD_REQUEST)
    except Table.DoesNotExist:
        return Response({"error": "指定餐桌不存在"}, status=status.HTTP_404_NOT_FOUND)

# 删除餐桌 - 返回反馈信息
@api_view(['DELETE'])
def delete_table(request, pk):
    try:
        table = Table.objects.get(pk=pk)
        table.delete()
        return Response({"message": "餐桌删除成功"}, status=status.HTTP_200_OK)
    except Table.DoesNotExist:
        return Response({"error": "指定餐桌不存在"}, status=status.HTTP_404_NOT_FOUND)

方式二：类视图（更优雅，适合大型项目，复用性强） #

用APIView来组织逻辑，结构更清晰：

# views.py
from rest_framework.views import APIView
from rest_framework.response import Response
from rest_framework import status
from .models import Table
from .serializers import TableSerializer

class TableAPIView(APIView):
    # 获取单个/所有餐桌
    def get(self, request, pk=None):
        if pk:
            try:
                table = Table.objects.get(pk=pk)
                serializer = TableSerializer(table)
                return Response(serializer.data)
            except Table.DoesNotExist:
                return Response({"error": "指定餐桌不存在"}, status=status.HTTP_404_NOT_FOUND)
        tables = Table.objects.all()
        serializer = TableSerializer(tables, many=True)
        return Response(serializer.data)
    
    # 更新餐桌
    def put(self, request, pk):
        try:
            table = Table.objects.get(pk=pk)
            serializer = TableSerializer(table, data=request.data, partial=True)
            if serializer.is_valid():
                serializer.save()
                return Response({
                    "message": "更新成功",
                    "table": serializer.data
                })
            return Response(serializer.errors, status=status.HTTP_400_BAD_REQUEST)
        except Table.DoesNotExist:
            return Response({"error": "指定餐桌不存在"}, status=status.HTTP_404_NOT_FOUND)
    
    # 删除餐桌
    def delete(self, request, pk):
        try:
            table = Table.objects.get(pk=pk)
            table.delete()
            return Response({"message": "餐桌已成功删除"}, status=status.HTTP_200_OK)
        except Table.DoesNotExist:
            return Response({"error": "指定餐桌不存在"}, status=status.HTTP_404_NOT_FOUND)

最后配置URL路由 #

记得在urls.py里把视图和路由绑定：

# urls.py
from django.urls import path
from . import views

urlpatterns = [
    # 函数视图路由
    path('tables/', views.table_list_or_detail, name='table-list'),
    path('tables/<int:pk>/', views.table_list_or_detail, name='table-detail'),
    path('tables/<int:pk>/update/', views.update_table, name='table-update'),
    path('tables/<int:pk>/delete/', views.delete_table, name='table-delete'),
    
    # 类视图路由（二选一即可）
    path('tables/api/', views.TableAPIView.as_view(), name='table-api-list'),
    path('tables/api/<int:pk>/', views.TableAPIView.as_view(), name='table-api-detail'),
]

这样就能满足你的需求：

• GET请求（获取单个/所有餐桌）直接返回序列化后的模型对象
• PUT/PATCH/DELETE请求返回包含操作结果的反馈信息，更新请求还可以附带更新后的模型数据，方便客户端同步

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