Django REST Framework (DRF) 提供了豐富的視圖類，用于構建 API 視圖。這些視圖類可以分為以下幾類：

---

1. 基礎視圖類

這些是 DRF 中最基礎的視圖類，通常用于實現自定義邏輯。

常用類

1. APIView：

   • 最基本的視圖類，所有其他視圖類都繼承自它。
   • 需要手動實現 get、post、put、delete 等方法。
   • 適合需要完全自定義邏輯的場景。

   from rest_framework.views import APIView
   from rest_framework.response import Responseclass MyView(APIView):def get(self, request):return Response({"message": "Hello, World!"})
   

2. GenericAPIView：

   • 繼承自 APIView，提供了更多的通用功能（如 get_queryset、get_serializer 等）。
   • 通常與 Mixin 類一起使用，以實現更高級的功能。

   from rest_framework.generics import GenericAPIView
   from rest_framework.response import Responseclass MyView(GenericAPIView):queryset = MyModel.objects.all()serializer_class = MyModelSerializerdef get(self, request):instances = self.get_queryset()serializer = self.get_serializer(instances, many=True)return Response(serializer.data)
   

---

2. 通用視圖類（Generic Views）

這些視圖類基于 GenericAPIView，并結合了 Mixin 類，提供了更高級的功能。

常用類

1. ListAPIView：

   • 用于實現列表視圖（只讀）。
   • 默認實現了 get 方法。

   from rest_framework.generics import ListAPIViewclass MyListView(ListAPIView):queryset = MyModel.objects.all()serializer_class = MyModelSerializer
   

2. RetrieveAPIView：

   • 用于實現詳情視圖（只讀）。
   • 默認實現了 get 方法。

   from rest_framework.generics import RetrieveAPIViewclass MyDetailView(RetrieveAPIView):queryset = MyModel.objects.all()serializer_class = MyModelSerializer
   

3. CreateAPIView：

   • 用于實現創建視圖。
   • 默認實現了 post 方法。

   from rest_framework.generics import CreateAPIViewclass MyCreateView(CreateAPIView):queryset = MyModel.objects.all()serializer_class = MyModelSerializer
   

4. UpdateAPIView：

   • 用于實現更新視圖。
   • 默認實現了 put 和 patch 方法。

   from rest_framework.generics import UpdateAPIViewclass MyUpdateView(UpdateAPIView):queryset = MyModel.objects.all()serializer_class = MyModelSerializer
   

5. DestroyAPIView：

   • 用于實現刪除視圖。
   • 默認實現了 delete 方法。

   from rest_framework.generics import DestroyAPIViewclass MyDeleteView(DestroyAPIView):queryset = MyModel.objects.all()serializer_class = MyModelSerializer
   

6. ListCreateAPIView：

   • 結合了 ListAPIView 和 CreateAPIView。
   • 默認實現了 get 和 post 方法。

   from rest_framework.generics import ListCreateAPIViewclass MyListCreateView(ListCreateAPIView):queryset = MyModel.objects.all()serializer_class = MyModelSerializer
   

7. RetrieveUpdateAPIView：

   • 結合了 RetrieveAPIView 和 UpdateAPIView。
   • 默認實現了 get、put 和 patch 方法。

   from rest_framework.generics import RetrieveUpdateAPIViewclass MyRetrieveUpdateView(RetrieveUpdateAPIView):queryset = MyModel.objects.all()serializer_class = MyModelSerializer
   

8. RetrieveDestroyAPIView：

   • 結合了 RetrieveAPIView 和 DestroyAPIView。
   • 默認實現了 get 和 delete 方法。

   from rest_framework.generics import RetrieveDestroyAPIViewclass MyRetrieveDestroyView(RetrieveDestroyAPIView):queryset = MyModel.objects.all()serializer_class = MyModelSerializer
   

9. RetrieveUpdateDestroyAPIView：

   • 結合了 RetrieveAPIView、UpdateAPIView 和 DestroyAPIView。
   • 默認實現了 get、put、patch 和 delete 方法。

   from rest_framework.generics import RetrieveUpdateDestroyAPIViewclass MyRetrieveUpdateDestroyView(RetrieveUpdateDestroyAPIView):queryset = MyModel.objects.all()serializer_class = MyModelSerializer
   

---

3. 視圖集（ViewSets）

視圖集將多個視圖邏輯組合在一起，通常與路由器（Router）一起使用，自動生成 URL 配置。

常用類

1. ViewSet：

   • 類似于 APIView，但將多個操作（如 list、create、retrieve 等）組合在一起。
   • 需要手動實現各個操作。

   from rest_framework import viewsets
   from rest_framework.response import Responseclass MyViewSet(viewsets.ViewSet):def list(self, request):return Response({"message": "List view"})def create(self, request):return Response({"message": "Create view"})
   

2. ModelViewSet：

   • 繼承自 GenericAPIView 和多個 Mixin 類，默認實現了完整的 CRUD 操作。
   • 適合標準的模型操作。

   from rest_framework import viewsetsclass MyModelViewSet(viewsets.ModelViewSet):queryset = MyModel.objects.all()serializer_class = MyModelSerializer
   

3. ReadOnlyModelViewSet：

   • 繼承自 ModelViewSet，但只提供只讀操作（list 和 retrieve）。

   from rest_framework import viewsetsclass MyReadOnlyViewSet(viewsets.ReadOnlyModelViewSet):queryset = MyModel.objects.all()serializer_class = MyModelSerializer
   

---

4. 其他視圖類

1. GenericViewSet：

   • 結合了 GenericAPIView 和 ViewSet 的功能。
   • 通常與 @action 裝飾器一起使用，定義自定義操作。

   from rest_framework import viewsets
   from rest_framework.decorators import action
   from rest_framework.response import Responseclass MyGenericViewSet(viewsets.GenericViewSet):@action(detail=False, methods=['get'])def custom_action(self, request):return Response({"message": "Custom action"})
   

2. mixins：

   • 提供了一些通用的功能（如 ListModelMixin、CreateModelMixin 等），通常與 GenericAPIView 或 GenericViewSet 一起使用。

---

總結

• 最常用的類：
  • APIView：適合完全自定義邏輯。
  • ModelViewSet：適合標準的模型 CRUD 操作。
  • ListAPIView、RetrieveAPIView 等：適合簡單的只讀或寫操作。
  • GenericAPIView：適合需要結合 Mixin 實現高級功能的場景。