Django視圖擴(kuò)展類(lèi)知識(shí)點(diǎn)詳解

更新時(shí)間：2019年10月25日 08:25:16 作者：Dr_wei

這篇文章主要介紹了Django視圖擴(kuò)展類(lèi)知識(shí)點(diǎn)以及實(shí)例代碼，需要的朋友們可以學(xué)習(xí)下。

擴(kuò)展類(lèi)必須配合GenericAPIView使用擴(kuò)展類(lèi)內(nèi)部的方法，在調(diào)用序列化器時(shí)，都是使用get_serializer

需要自定義get、post等請(qǐng)求方法，內(nèi)部實(shí)現(xiàn)調(diào)用擴(kuò)展類(lèi)對(duì)應(yīng)方法即可。

一、mixins的視圖子類(lèi)

作用：

提供了幾種后端視圖（對(duì)數(shù)據(jù)資源進(jìn)行曾刪改查）處理流程的實(shí)現(xiàn)，如果需要編寫(xiě)的視圖屬于這五種，則視圖可以通過(guò)繼承相應(yīng)的擴(kuò)展類(lèi)來(lái)復(fù)用代碼，減少自己編寫(xiě)的代碼量。

這五個(gè)擴(kuò)展類(lèi)需要搭配GenericAPIView父類(lèi)，因?yàn)槲鍌€(gè)擴(kuò)展類(lèi)的實(shí)現(xiàn)需要調(diào)用GenericAPIView提供的序列化器與數(shù)據(jù)庫(kù)查詢(xún)的方法。

1.1 ListModelMixin

列表視圖擴(kuò)展類(lèi)，提供list(request, *args, **kwargs)方法快速實(shí)現(xiàn)列表視圖，返回200狀態(tài)碼。

提供list方法，快速實(shí)現(xiàn)列表視圖
調(diào)用GenericAPIView設(shè)置好的結(jié)果集
調(diào)用GenericAPIView設(shè)置好的序列化器

該Mixin的list()方法會(huì)對(duì)數(shù)據(jù)進(jìn)行過(guò)濾和分頁(yè)。

源代碼：

from rest_framework.mixins import ListModelMixin

class ListModelMixin(object):
  """
  List a queryset.
  """
  def list(self, request, *args, **kwargs):
    # 過(guò)濾
    queryset = self.filter_queryset(self.get_queryset())
    # 分頁(yè)
    page = self.paginate_queryset(queryset)
    if page is not None:
      serializer = self.get_serializer(page, many=True)
      return self.get_paginated_response(serializer.data)
    # 序列化
    serializer = self.get_serializer(queryset, many=True)
    return Response(serializer.data)

舉例：

from rest_framework.mixins import ListModelMixin
from rest_framework.generics import GenericAPIView

class BookListView(ListModelMixin, GenericAPIView):
  queryset = BookInfo.objects.all()
  serializer_class = BookInfoSerializer

  def get(self, request):
    return self.list(request)

1.2 CreateModelMixin
創(chuàng)建視圖擴(kuò)展類(lèi)，提供create(request, *args, **kwargs)方法快速實(shí)現(xiàn)創(chuàng)建資源的視圖，成功返回201狀態(tài)碼。

提供create(request, *args, **kwargs)方法快速實(shí)現(xiàn)創(chuàng)建資源的視圖
實(shí)際創(chuàng)建功能由序列化的save方法完成
save方法會(huì)去調(diào)用序列化器的create方法

如果序列化器對(duì)前端發(fā)送的數(shù)據(jù)驗(yàn)證失敗，返回400錯(cuò)誤。

源代碼：

from rest_framework.mixins import CreateModelMixin

class CreateModelMixin(object):
  """
  Create a model instance.
  """
  def create(self, request, *args, **kwargs):
    # 獲取序列化器
    serializer = self.get_serializer(data=request.data)
    # 驗(yàn)證
    serializer.is_valid(raise_exception=True)
    # 保存
    self.perform_create(serializer)
    headers = self.get_success_headers(serializer.data)
    return Response(serializer.data, status=status.HTTP_201_CREATED, headers=headers)

  def perform_create(self, serializer):
    serializer.save()

  def get_success_headers(self, data):
    try:
      return {'Location': str(data[api_settings.URL_FIELD_NAME])}
    except (TypeError, KeyError):
      return {}

1.3 RetrieveModelMixin

詳情視圖擴(kuò)展類(lèi)，提供retrieve(request, *args, **kwargs)方法，可以快速實(shí)現(xiàn)返回一個(gè)存在的數(shù)據(jù)對(duì)象。

如果存在，返回200，否則返回404。

源代碼：

from rest_framework.mixins import RetrieveModelMixin

class RetrieveModelMixin(object):
  """
  Retrieve a model instance.
  """
  def retrieve(self, request, *args, **kwargs):
    # 獲取對(duì)象，會(huì)檢查對(duì)象的權(quán)限
    instance = self.get_object()
    # 序列化
    serializer = self.get_serializer(instance)
    return Response(serializer.data)

舉例：

from rest_framework.mixins import RetrieveModelMixin
from rest_framework.generics import GenericAPIView

class BookDetailView(RetrieveModelMixin, GenericAPIView):
  queryset = BookInfo.objects.all()
  serializer_class = BookInfoSerializer

  def get(self, request, pk):
    return self.retrieve(request)

1.4 UpdateModelMixin
更新視圖擴(kuò)展類(lèi)，提供update(request, *args, **kwargs)方法

可以快速實(shí)現(xiàn)更新一個(gè)存在的數(shù)據(jù)對(duì)象。
同時(shí)也提供partial_update(request, *args, **kwargs)方法，可以實(shí)現(xiàn)局部更新。
內(nèi)部更新功能調(diào)用序列化器的save方法
save方法會(huì)調(diào)用序列化器的update方法

成功返回200，序列化器校驗(yàn)數(shù)據(jù)失敗時(shí)，返回400錯(cuò)誤。

源代碼：

from rest_framework.mixins import UpdateModelMixin

class UpdateModelMixin(object):
  """
  Update a model instance.
  """
  def update(self, request, *args, **kwargs):
    partial = kwargs.pop('partial', False)
    instance = self.get_object()
    serializer = self.get_serializer(instance, data=request.data, partial=partial)
    serializer.is_valid(raise_exception=True)
    self.perform_update(serializer)

    if getattr(instance, '_prefetched_objects_cache', None):
      # If 'prefetch_related' has been applied to a queryset, we need to
      # forcibly invalidate the prefetch cache on the instance.
      instance._prefetched_objects_cache = {}

    return Response(serializer.data)

  def perform_update(self, serializer):
    serializer.save()

  def partial_update(self, request, *args, **kwargs):
    kwargs['partial'] = True
    return self.update(request, *args, **kwargs)

1.5 DestroyModelMixin

刪除視圖擴(kuò)展類(lèi)，提供destroy(request, *args, **kwargs)方法，可以快速實(shí)現(xiàn)刪除一個(gè)存在的數(shù)據(jù)對(duì)象。

成功返回204，不存在返回404。

源代碼：

from rest_framework.mixins import DestroyModelMixin

class DestroyModelMixin(object):
  """
  Destroy a model instance.
  """
  def destroy(self, request, *args, **kwargs):
    instance = self.get_object()
    self.perform_destroy(instance)
    return Response(status=status.HTTP_204_NO_CONTENT)

  def perform_destroy(self, instance):
    instance.delete()

使用GenericAPIView和視圖擴(kuò)展類(lèi)，實(shí)現(xiàn)api接口，代碼：

"""GenericAPIView結(jié)合視圖擴(kuò)展類(lèi)實(shí)現(xiàn)api接口"""
from rest_framework.generics import GenericAPIView
from rest_framework.mixins import ListModelMixin,CreateModelMixin

class Students2GenericAPIView(GenericAPIView,ListModelMixin,CreateModelMixin):
  # 本次視圖類(lèi)中要操作的數(shù)據(jù)[必填]
  queryset = Student.objects.all()
  # 本次視圖類(lèi)中要調(diào)用的默認(rèn)序列化器[玄天]
  serializer_class = StudentModelSerializer

  def get(self, request):
    """獲取多個(gè)學(xué)生信息"""
    return self.list(request)

  def post(self,request):
    """添加學(xué)生信息"""
    return self.create(request)

from rest_framework.mixins import RetrieveModelMixin,UpdateModelMixin,DestroyModelMixin
from rest_framework.generics import GenericAPIView

class Student2GenericAPIView(GenericAPIView,RetrieveModelMixin,UpdateModelMixin,DestroyModelMixin):
  queryset = Student.objects.all()

  serializer_class = StudentModelSerializer

  # 在使用GenericAPIView視圖獲取或操作單個(gè)數(shù)據(jù)時(shí),視圖方法中的代表主鍵的參數(shù)最好是pk
  def get(self,request,pk):
    """獲取一條數(shù)據(jù)"""
    return self.retrieve(request,pk)

  def put(self,request,pk):
    """更新一條數(shù)據(jù)"""
    return self.update(request,pk)

  def delete(self,request,pk):
    """刪除一條數(shù)據(jù)"""
    return self.destroy(request,pk)

二、Generic的視圖子類(lèi)

2.1 CreateAPIView

提供 post方法

繼承自： GenericAPIView、`CreateModelMixin

2.2 ListAPIView

提供 get 方法

繼承自：GenericAPIView、ListModelMixin

2.3 RetrieveAPIView

提供 get方法

繼承自: GenericAPIView、RetrieveModelMixin

2.4 DestoryAPIView

提供 delete方法