㈠ . ViewSet 檢視集

ViewSetMixin裡重寫了as_view方法，可以更方便的繫結actions。


ViewSet檢視集類不再實現get()、post()等方法，而是實現動作 action 如 list() 、create() 等。
檢視集只在使用as_view()方法的時候，才會將action動作與具體請求方式對應上

常用檢視集的父類：

1） ViewSet

繼承自APIView，作用也與APIView基本類似，提供了身份認證、許可權校驗、流量管理等。
在ViewSet中，沒有提供任何動作action方法，需要我們自己實現action方法。

2）GenericViewSet

3）ModelViewSet
繼承自GenericAPIVIew，同時包括了ListModelMixin、RetrieveModelMixin、CreateModelMixin、UpdateModelMixin、DestoryModelMixin。

4）ReadOnlyModelViewSet
繼承自GenericAPIVIew，同時包括了ListModelMixin、RetrieveModelMixin;

action屬性：
比如：

urlpatterns = [
url(r’^books/ $ ‘, views.BookInfoViewSet.as_view({‘get’: ‘list’})),
url(r’^books/latest/$ ‘, views.BookInfoViewSet.as_view({‘get’: ‘latest’})),
url(r’^books/(?P\d+)/$ ‘, views.BookInfoViewSet.as_view({‘get’: ‘retrieve’})),
url(r’^books/(?P\d+)/read/$’ , views.BookInfoViewSet.as_view({‘put’: ‘read’})),
]

在檢視集中，我們可以通過action物件屬性來獲取當前請求檢視集時的action動作是哪個

現在以ModelViewSet 做程式碼案例演示：

class BookInfoAPIView(ModelViewSet):
    # 定義檢視的查詢集
    queryset = BookInfo.objects.all()
    # 指定檢視對應的序列化器
    serializer_class = BookInfoModelSerializer

# url.py中的urlatterns配置
url(r'books/(?P<pk>\d+)/$', views.BookInfoAPIView.as_view({'get': 'retrieve'})),
url(r'books/', views.BookInfoAPIView.as_view({'get': 'list'}))

在繼承了ModelViewSet之後，我們只要在路由中配置的時候，說明什麼請求對應什麼action，就可以很簡單的完成檢視函式的關於資料庫的簡單的增刪改查。

㈡ . 路由router

上面的方式定義路由，相對來說，還是比較繁瑣的，我們現在可以使用更簡單的。

REST framework提供了兩個router：

• SimpleRouter
• DefaultRouter

DefaultRouter與SimpleRouter的區別是，DefaultRouter會多附帶一個預設的API根檢視，返回一個包含所有列表檢視的超連結響應資料。

使用方法：

（1）：建立router物件，並註冊檢視集

from rest_framework import routers

router = routers.SimpleRouter()
router.register(r'books', BookInfoAPIView, base_name='book')

register(prefix, viewset, base_name)

• prefix 該檢視集的路由字首
• viewset 檢視集
• base_name 路由名稱的字首

（2）：新增路由資料到urlpatterns中
有下面兩種方式都可以

urlpatterns = [
    ...
]
urlpatterns += router.urls

urlpatterns = [
    ...
    url(r'^', include(router.urls))
]

路由router形成URL的方式：

㈢ . 檢視集中定義附加action動作

雖然ModelViewSet給我們提供了很簡單的定義檢視函式的方法，但是，並不能滿足咱們的所有需求，所以我們得需要自己定義action動作。

新增自定義動作需要使用rest_framework.decorators.action裝飾器。

以action裝飾器裝飾的方法名會作為action動作名，與list、retrieve等同。

action裝飾器可以接收兩個引數：

1. methods: 該action支援的請求方式，列表傳遞
2. detail: 表示是action中要處理的是否是檢視資源的物件（即是否通過url路徑獲取主鍵）

detail引數：

• True 表示使用通過URL獲取的主鍵對應的資料物件
• False 表示不使用URL獲取主鍵

class BookInfoAPIView(ModelViewSet):
    # 定義檢視的查詢集
    queryset = BookInfo.objects.all()
    # 指定檢視對應的序列化器
    serializer_class = BookInfoModelSerializer

    # 自定義action動作
    @action(methods=['get'], detail=False)
    def latest(self, request):
        # 本action是獲取最新的書
        book = BookInfo.objects.latest('id')
        ser = self.get_serializer(book)
        return Response(ser.data)

㈣. 檢視函式繼承關係

這個是從pycharm直接匯出的，可以根據圖示將檢視之間的繼承關係梳理清楚。