03. Django REST framework - 视图组件
视图继承关系
详图见文章末尾
视图
REST framework 提供了众多的通用视图基类与扩展类,以简化视图的编写。
2个视图基类
APIView
APIView 是REST framework提供的所有视图的基类,继承自Django的View父类。
from rest_framework.views import APIView APIView与View的不同之处在于: 传入到视图方法中的是REST framework的Request对象,而不是Django的HttpRequeset对象; 视图方法可以返回REST framework的Response对象,视图会为响应数据设置(render)符合前端要求的格式; 任何APIException异常都会被捕获到,并且处理成合适的响应信息; 在进行dispatch()分发前,会对请求进行身份认证、权限检查、流量控制。 支持定义的类属性 authentication_classes 列表或元祖,身份认证类 permissoin_classes 列表或元祖,权限检查类 throttle_classes 列表或元祖,流量控制类 在APIView中仍以常规的类视图定义方法来实现get() 、post() 或者其他请求方式的方法 ********示例在下方*******
GenericAPIView[通用视图类]
继承自APIVIew,主要增加了操作序列化器和数据库查询的方法,作用是为下面Mixin扩展类的执行提供方法支持。通常在使用时,可搭配一个或多个Mixin扩展类。
from rest_framework.generics import GenericAPIView
GenericAPIView(APIView):做了一些封装
-属性:
queryset # 要序列化的数据
serializer_class # 指明视图使用的序列化器
-方法:
get_queryset:获取qs数据(返回视图使用的查询集,主要用来提供给Mixin扩展类使用,
是列表视图与详情视图获取数据的基础,默认返回queryset属性)
get_object:获取一条数据的对象(返回详情视图所需的模型类数据对象,主要用来
提供给Mixin扩展类使用。在试图中可以调用该方法获取详情信息的模型类对象)
get_serializer:以后使用它来实例化得到ser对象(返回序列化器对象,主要用来
提供给Mixin扩展类使用,如果我们在视图中想要获取序列化器对象,也可以直接调用此方法)
get_serializer_class:获取序列化类,注意跟上面区分
作用:
提供了几种后端视图(对数据资源进行曾删改查)处理流程的实现,如果需要编写的视图属于这五种,则视图可以通过继承相应的扩展类来复用代码,减少自己编写的代码量。
这五个扩展类需要搭配GenericAPIView父类,因为五个扩展类的实现需要调用GenericAPIView提供的序列化器与数据库查询的方法。
1 查所有:ListModelMixin
列表视图扩展类,提供list(request, *args, **kwargs)方法快速实现列表视图,返回200状态码。
该Mixin的list方法会对数据进行过滤和分页。
2 查一个:RetrieveModelMixin
创建视图扩展类,提供create(request, *args, **kwargs)方法快速实现创建资源的视图,成功返回201状态码。
如果序列化器对前端发送的数据验证失败,返回400错误。
3 增一个:CreateModelMixin
详情视图扩展类,提供retrieve(request, *args, **kwargs)方法,可以快速实现返回一个存在的数据对象。
如果存在,返回200, 否则返回404
4 改一个:UpdateModelMixin
更新视图扩展类,提供update(request, *args, **kwargs)方法,可以快速实现更新一个存在的数据对象。
同时也提供partial_update(request, *args, **kwargs)方法,可以实现局部更新。
成功返回200,序列化器校验数据失败时,返回400错误。
5 删一个:DestroyModelMixin
删除视图扩展类,提供destroy(request, *args, **kwargs)方法,可以快速实现删除一个存在的数据对象
成功返回204,不存在返回404。
1)查所有:ListAPIView 提供 get 方法 继承自:GenericAPIView、ListModelMixin 2)增一个:CreateAPIView 提供 post 方法 继承自: GenericAPIView、CreateModelMixin 3)查所有+增一个:ListCreateAPIView 提供 get 和 post 方法 继承自: GenericAPIView、ListModelMixin、CreateModelMixin 4)查一个:RetrieveAPIView 提供 get 方法 继承自: GenericAPIView、RetrieveModelMixin 5)改一个:UpdateAPIView 提供 put 和 patch 方法 继承自:GenericAPIView、UpdateModelMixin 6)删一个:DestoryAPIView 提供 delete 方法 继承自:GenericAPIView、DestoryModelMixin 7)查一个+改一个:RetrieveUpdateAPIView 提供 get、put、patch方法 继承自: GenericAPIView、RetrieveModelMixin、UpdateModelMixin 8)查一个+删一个:RetrieveDestroyAPIView 提供 get 和 delete 方法 继承自: GenericAPIView、RetrieveModelMixin、DestoryModelMixin 9) 查一个+改一个+删一个:RetrieveUpdateDestoryAPIView 提供 get、put、patch、delete方法 继承自:GenericAPIView、RetrieveModelMixin、UpdateModelMixin、DestoryModelMixin
视图类的使用
下面把APIView 、GenericAPIView、5个视图扩展类、9个视图子类分四层来做演示
from django.db import models
class Book(models.Model):
nid = models.AutoField(primary_key=True)
name = models.CharField(max_length=32, verbose_name='书名')
price = models.DecimalField(max_digits=5, decimal_places=2, verbose_name='价格')
publish_date = models.DateField(verbose_name='出版时间')
publish = models.ForeignKey(to='Publish',to_field='nid',on_delete=models.CASCADE)
authors=models.ManyToManyField(to='Author')
class Meta:
verbose_name_plural = '书籍表'
def __str__(self):
return self.name
class Author(models.Model):
nid = models.AutoField(primary_key=True)
name = models.CharField(max_length=32, verbose_name='名字')
age = models.IntegerField(verbose_name='年龄')
author_detail = models.OneToOneField(to='AuthorDetail',to_field='nid',unique=True,on_delete=models.CASCADE)
class Meta:
verbose_name_plural = '作者表'
def __str__(self):
return self.name
class AuthorDetail(models.Model):
nid = models.AutoField(primary_key=True)
telephone = models.BigIntegerField(verbose_name='电话')
birthday = models.DateField(verbose_name='生日')
addr = models.CharField(max_length=64, verbose_name='地址')
class Meta:
verbose_name_plural = '作者详情表'
class Publish(models.Model):
nid = models.AutoField(primary_key=True)
name = models.CharField(max_length=32, verbose_name='社名')
city = models.CharField(max_length=32, verbose_name='地址')
email = models.EmailField(verbose_name='邮箱')
class Meta:
verbose_name_plural = '出版社表'
def __str__(self):
return self.name
from django.contrib import admin
from django.urls import path
from app01 import views
urlpatterns = [
path('admin/', admin.site.urls),
# 查询所有书籍,新增一本书籍
path('book/', views.BookView.as_view()),
# 查询,修改,删除单本书籍
path('book/<int:pk>/', views.BookSingleView.as_view()),
# 查询所有作者,增加一个作者
path('author/', views.AuthorView.as_view()),
# 查询,修改,删除单个作者
path('author/<int:pk>/', views.AuthorSingleView.as_view()),
# 查询所有作者详情,新增一个作者详情
path('authordetail/', views.AuthorDetailView.as_view()),
# 查询,修改,删除单个作者详情
path('authordetail/<int:pk>/', views.AuthorDetailSingleView.as_view()),
# 查询所有出版社,新增一个出版社
path('publish/', views.PublishView.as_view()),
# 查询,修改,删除单个出版社
path('publish/<int:pk>/', views.PublishSingleView.as_view()),
]
from rest_framework.response import Response
from app01 import serializer
from app01 import models
****** 第一层:继承APIview ******
from rest_framework.views import APIView
# 查询所有书籍,增加书籍
class BookView(APIView):
def get(self, request):
books = models.Book.objects.all()
ser = serializer.BookModelSerializer(instance=books, many=True)
return Response(ser.data)
def post(self, request):
ser = serializer.BookModelSerializer(data=request.data)
if ser.is_valid():
# 直接保存,保存到哪个表里?需要重写save
ser.save()
return Response(ser.data)
return Response(ser.errors)
# 查询,修改,删除单本书籍
class BookSingleView(APIView):
def get(self, request, *args, **kwargs):
book = models.Book.objects.filter(pk=kwargs.get('pk')).first()
ser = serializer.BookModelSerializer(instance=book)
print(ser.instance)
return Response(ser.data)
def put(self, request, *args, **kwargs):
book = models.Book.objects.filter(pk=kwargs.get('pk')).first()
ser = serializer.BookModelSerializer(instance=book, data=request.data)
if ser.is_valid():
ser.save()
return Response(ser.data)
else:
return Response('数据校验有误')
def delete(self, request, *args, **kwargs):
book = models.Book.objects.filter(pk=kwargs.get('pk')).delete()
print(book)
if book[0] > 0:
return Response('')
else:
return Response('要删的不存在')
# 查询所有作者,增加作者
class AuthorView(APIView):
def get(self,request):
author = models.Author.objects.all()
ser = serializer.AuthorModelSerializer(instance=author,many=True)
return Response(ser.data)
def post(self,request):
ser = serializer.AuthorModelSerializer(data=request.data)
if ser.is_valid():
ser.save()
return Response(ser.data)
return Response(ser.errors)
# 查询,修改,删除单个作者
class AuthorSingleView(APIView):
def get(self,request, *args, **kwargs):
author = models.Author.objects.filter(pk=kwargs.get('pk')).first()
ser = serializer.AuthorModelSerializer(instance=author)
return Response(ser.data)
def put(self, request, *args, **kwargs):
author = models.Author.objects.filter(pk=kwargs.get('pk')).first()
ser = serializer.AuthorModelSerializer(instance=author, data=request.data)
if ser.is_valid():
ser.save()
return Response(ser.data)
return Response(ser.errors)
def delete(self, request, *args, **kwargs):
author = models.Author.objects.filter(pk=kwargs.get('pk')).delete()
if author[0] > 0:
return Response('')
return Response('要删的不存在')
# 查询所有作者详情,增加作者详情
class AuthorDetailView(APIView):
def get(self, request):
author_detail = models.AuthorDetail.objects.all()
ser = serializer.AuthorDatailModelserializer(instance=author_detail, many=True)
return Response(ser.data)
def post(self,request):
ser = serializer.AuthorDatailModelserializer(data=request.data)
if ser.is_valid():
ser.save()
return Response(ser.data)
return Response(ser.errors)
# 查询,修改,删除,单个作者详情
class AuthorDetailSingleView(APIView):
def get(self, request, *args, **kwargs):
author_detail = models.AuthorDetail.objects.filter(pk=kwargs.get('pk')).first()
ser = serializer.AuthorDatailModelserializer(instance=author_detail)
return Response(ser.data)
def put(self, request, *args, **kwargs):
author_detail = models.AuthorDetail.objects.filter(pk=kwargs.get('pk')).first()
ser = serializer.AuthorDatailModelserializer(instance=author_detail, data=request.data)
if ser.is_valid():
ser.save()
return Response(ser.data)
return Response('数据校验有误')
def delete(self, request,*args,**kwargs):
author_detail = models.AuthorDetail.objects.filter(pk=kwargs.get('pk')).delete()
if author_detail[0] > 0:
return Response('')
return Response('要删的数据不存在')
# 查询所有出版社,增加出版社
class PublishView(APIView):
def get(self, request):
publish = models.Publish.objects.all()
ser = serializer.PublishModelSerializer(instance=publish, many=True)
return Response(ser.data)
def post(self, request):
ser = serializer.PublishModelSerializer(data=request.data)
if ser.is_valid():
# 直接保存,保存到哪个表里?需要重写save
ser.save()
return Response(ser.data)
return Response(ser.errors)
# 查询,修改,删除单个出版社
class PublishSingleView(APIView):
def get(self, request, *args, **kwargs):
publish = models.Publish.objects.filter(pk=kwargs.get('pk')).first()
ser = serializer.PublishModelSerializer(instance=publish)
print(ser.instance)
return Response(ser.data)
def put(self, request, *args, **kwargs):
publish = models.Publish.objects.filter(pk=kwargs.get('pk')).first()
ser = serializer.PublishModelSerializer(instance=publish, data=request.data)
if ser.is_valid():
ser.save()
return Response(ser.data)
else:
return Response('数据校验有误')
def delete(self, request, *args, **kwargs):
publish = models.Publish.objects.filter(pk=kwargs.get('pk')).delete()
if publish[0] > 0:
return Response('')
else:
return Response('要删的不存在')
************************* 第二层:继承GenericAPIView **************************
from rest_framework.generics import GenericAPIView
# 查询所有书籍,增加书籍
class BookView(GenericAPIView):
queryset = models.Book.objects.all() # 要序列化的数据
serializer_class = serializer.BookModelSerializer # 要序列化的类
def get(self, request):
qs = self.get_queryset() # 推荐用self.get_queryset来获取要序列化的数据
ser = self.get_serializer(qs, many=True) # 推荐使用self.get_serializer获取实例化后并且传入数据的对象
return Response(ser.data)
def post(self, request):
ser = self.get_serializer(data=request.data)
if ser.is_valid():
ser.save()
return Response(ser.data)
return Response(ser.errors)
# 查询,修改,删除单本书籍
class BookSingleView(GenericAPIView):
queryset = models.Book.objects.all() # 要序列化的数据
serializer_class = serializer.BookModelSerializer # 要序列化的类
def get(self, request, *args, **kwargs):
obj = self.get_object() # 获取单条self.get_object要序列化的数据
ser = self.get_serializer(obj) # 第一个参数是instance=obj,可以直接写obj
return Response(ser.data)
def put(self, request, *args, **kwargs):
obj = self.get_object()
ser = self.get_serializer(instance=obj, data=request.data)
if ser.is_valid():
ser.save()
return Response(ser.data)
else:
return Response(ser.errors)
def delete(self, request, *args, **kwargs):
res = self.get_object().delete() # get_object()拿到对象直接删除了
if res[0] > 0:
return Response('')
else:
return Response('要删的不存在')
# 查询所有作者,新增作者
class AuthorView(GenericAPIView):
queryset = models.Author.objects.all() # 要序列化的数据
serializer_class = serializer.AuthorModelSerializer # 要序列化的类
def get(self, request):
qs = self.get_queryset() # 推荐用self.get_queryset来获取要序列化的数据
ser = self.get_serializer(qs, many=True) # 推荐使用self.get_serializer获取实例化后并且传入数据的对象
return Response(ser.data)
def post(self, request):
ser = self.get_serializer(data=request.data)
if ser.is_valid():
ser.save()
return Response(ser.data)
return Response(ser.errors)
# 查询,修改,删除单个作者
class AuthorSingleView(GenericAPIView):
queryset = models.Author.objects.all() # 要序列化的数据
serializer_class = serializer.AuthorModelSerializer # 要序列化的类
def get(self, request, *args, **kwargs):
obj = self.get_object() # 获取单条self.get_object要序列化的数据
ser = self.get_serializer(obj) # 第一个参数是instance=obj,可以直接写obj
return Response(ser.data)
def put(self, request, *args, **kwargs):
obj = self.get_object()
ser = self.get_serializer(instance=obj, data=request.data)
if ser.is_valid():
ser.save()
return Response(ser.data)
else:
return Response(ser.errors)
def delete(self, request, *args, **kwargs):
res = self.get_object().delete() # get_object()拿到对象直接删除了
if res[0] > 0:
return Response('')
else:
return Response('要删的不存在')
# 查询所有作者详情,增加作者详情
class AuthorDetailView(GenericAPIView):
queryset = models.AuthorDetail.objects.all() # 要序列化的数据
serializer_class = serializer.AuthorDatailModelserializer # 要序列化的类
def get(self, request) :
qs = self.get_queryset() # 推荐用self.get_queryset来获取要序列化的数据
ser = self.get_serializer(qs, many=True) # 推荐使用self.get_serializer获取实例化后并且传入数据的对象
return Response(ser.data)
def post(self, request) :
ser = self.get_serializer(data=request.data)
if ser.is_valid() :
ser.save()
return Response(ser.data)
return Response(ser.errors)
# 查询,修改,删除,单个作者详情
class AuthorDetailSingleView(GenericAPIView):
queryset = models.AuthorDetail.objects.all() # 要序列化的数据
serializer_class = serializer.AuthorDatailModelserializer # 要序列化的类
def get(self, request, *args, **kwargs) :
obj = self.get_object() # 获取单条self.get_object要序列化的数据
ser = self.get_serializer(obj) # 第一个参数是instance=obj,可以直接写obj
return Response(ser.data)
def put(self, request, *args, **kwargs) :
obj = self.get_object()
ser = self.get_serializer(instance=obj, data=request.data)
if ser.is_valid():
ser.save()
return Response(ser.data)
else :
return Response(ser.errors)
def delete(self, request, *args, **kwargs) :
res = self.get_object().delete() # get_object()拿到对象直接删除了
if res[0] > 0 :
return Response('')
else :
return Response('要删的不存在')
# 查询所有出版社,增加出版社
class PublishView(GenericAPIView) :
queryset = models.Publish.objects.all() # 要序列化的数据
serializer_class = serializer.PublishModelSerializer # 要序列化的类
def get(self, request):
qs = self.get_queryset() # 推荐用self.get_queryset来获取要序列化的数据
ser = self.get_serializer(qs, many=True) # 推荐使用self.get_serializer获取实例化后并且传入数据的对象
return Response(ser.data)
def post(self, request):
ser = self.get_serializer(data=request.data)
if ser.is_valid():
ser.save()
return Response(ser.data)
return Response(ser.errors)
# 查询,修改,删除,单个作者详情
class PublishSingleView(GenericAPIView):
queryset = models.Publish.objects.all() # 要序列化的数据
serializer_class = serializer.PublishModelSerializer # 要序列化的类
def get(self, request, *args, **kwargs) :
obj = self.get_object() # 获取单条self.get_object要序列化的数据
ser = self.get_serializer(obj) # 第一个参数是instance=obj,可以直接写obj
return Response(ser.data)
def put(self, request, *args, **kwargs) :
obj = self.get_object()
ser = self.get_serializer(instance=obj, data=request.data)
if ser.is_valid():
ser.save()
return Response(ser.data)
else :
return Response(ser.errors)
def delete(self, request, *args, **kwargs) :
res = self.get_object().delete() # get_object()拿到对象直接删除了
if res[0] > 0 :
return Response('')
else :
return Response('要删的不存在')
******************* 第三层:继承GenericAPIView+5个视图扩展类 *******************
# 5个视图扩展类:每个类内部只有一个方法,一个类只完成一个事
from rest_framework.generics import GenericAPIView
from rest_framework.mixins import CreateModelMixin,RetrieveModelMixin,UpdateModelMixin,DestroyModelMixin,ListModelMixin
# 查询所有书籍,增加一本书籍
class BookView(GenericAPIView, ListModelMixin, CreateModelMixin):
queryset = models.Book.objects.all() # 要序列化的数据
serializer_class = serializer.BookModelSerializer # 要序列化的类
def get(self, request, *args, **kwargs): # 不管有值无值最好都把 *args, **kwargs传过来
return self.list(request, *args, **kwargs)
def post(self, request):
return self.create(request)
# 查询,修改,删除单本书籍
class BookSingleView(GenericAPIView, RetrieveModelMixin, UpdateModelMixin, DestroyModelMixin):
queryset = models.Book.objects.all() # 要序列化的数据
serializer_class = serializer.BookModelSerializer # 要序列化的类
def get(self, request, *args, **kwargs):
return self.retrieve(request, *args, **kwargs)
def put(self, request, *args, **kwargs):
return self.update(request, *args, **kwargs)
def delete(self, request, *args, **kwargs):
return self.destroy(request, *args, **kwargs)
# 查询所有作者,新增作者
class AuthorView(GenericAPIView, ListModelMixin, CreateModelMixin):
queryset = models.Author.objects.all() # 要序列化的数据
serializer_class = serializer.AuthorModelSerializer # 要序列化的类
def get(self, request, *args, **kwargs):
return self.list(request, *args, **kwargs)
def post(self, request):
return self.create(request)
# 查询,修改,删除单个作者
class AuthorSingleView(GenericAPIView, RetrieveModelMixin, UpdateModelMixin, DestroyModelMixin):
queryset = models.Author.objects.all() # 要序列化的数据
serializer_class = serializer.AuthorModelSerializer # 要序列化的类
def get(self, request, *args, **kwargs):
return self.retrieve(request, *args, **kwargs)
def put(self, request, *args, **kwargs):
return self.update(request, *args, **kwargs)
def delete(self, request, *args, **kwargs):
return self.destroy(request, *args, **kwargs)
# 查询所有作者详情,增加作者详情
class AuthorDetailView(GenericAPIView, ListModelMixin, CreateModelMixin):
queryset = models.AuthorDetail.objects.all() # 要序列化的数据
serializer_class = serializer.AuthorDatailModelserializer # 要序列化的类
def get(self, request, *args, **kwargs):
return self.list(request, *args, **kwargs)
def post(self, request):
return self.create(request)
# 查询,修改,删除,单个作者详情
class AuthorDetailSingleView(GenericAPIView, RetrieveModelMixin, UpdateModelMixin, DestroyModelMixin):
queryset = models.AuthorDetail.objects.all() # 要序列化的数据
serializer_class = serializer.AuthorDatailModelserializer # 要序列化的类
def get(self, request, *args, **kwargs):
return self.retrieve(request, *args, **kwargs)
def put(self, request, *args, **kwargs):
return self.update(request, *args, **kwargs)
def delete(self, request, *args, **kwargs):
return self.destroy(request, *args, **kwargs)
# 查询所有出版社,增加出版社
class PublishView(GenericAPIView, ListModelMixin, CreateModelMixin):
queryset = models.Publish.objects.all() # 要序列化的数据
serializer_class = serializer.PublishModelSerializer # 要序列化的类
def get(self, request, *args, **kwargs):
return self.list(request, *args, **kwargs)
def post(self, request):
return self.create(request)
# 查询,修改,删除,单个作者详情
class PublishSingleView(GenericAPIView, RetrieveModelMixin, UpdateModelMixin, DestroyModelMixin):
queryset = models.Publish.objects.all() # 要序列化的数据
serializer_class = serializer.PublishModelSerializer # 要序列化的类
def get(self, request, *args, **kwargs):
return self.retrieve(request, *args, **kwargs)
def put(self, request, *args, **kwargs):
return self.update(request, *args, **kwargs)
def delete(self, request, *args, **kwargs):
return self.destroy(request, *args, **kwargs)
*************** 第四层:9个视图子类 GenericAPIView+5个视图扩展类之一,之二,或之三 ****************
from rest_framework.generics import CreateAPIView, ListAPIView, ListCreateAPIView
from rest_framework.generics import RetrieveAPIView, UpdateAPIView, DestroyAPIView, RetrieveUpdateAPIView, RetrieveDestroyAPIView, RetrieveUpdateDestroyAPIView
# 查询所有书籍,增加一本书籍
class BookView(ListCreateAPIView):
queryset = models.Book.objects.all() # 要序列化的数据
serializer_class = serializer.BookModelSerializer # 要序列化的类
# 查询,修改,删除单本书籍
class BookSingleView(RetrieveUpdateDestroyAPIView):
queryset = models.Book.objects.all() # 要序列化的数据
serializer_class = serializer.BookModelSerializer # 要序列化的类
# 查询所有作者,新增一个作者
class AuthorView(ListAPIView, CreateAPIView):
queryset = models.Author.objects.all() # 要序列化的数据
serializer_class = serializer.AuthorModelSerializer # 要序列化的类
# 查询,修改,删除单个作者
class AuthorSingleView(RetrieveAPIView, UpdateAPIView, DestroyAPIView):
queryset = models.Author.objects.all() # 要序列化的数据
serializer_class = serializer.AuthorModelSerializer # 要序列化的类
# 查询所有作者详情,增加作者详情
class AuthorDetailView(ListCreateAPIView):
queryset = models.AuthorDetail.objects.all() # 要序列化的数据
serializer_class = serializer.AuthorDatailModelserializer # 要序列化的类
# 查询,修改,删除,单个作者详情
class AuthorDetailSingleView(RetrieveUpdateAPIView, DestroyAPIView):
queryset = models.AuthorDetail.objects.all() # 要序列化的数据
serializer_class = serializer.AuthorDatailModelserializer # 要序列化的类
# 查询所有出版社,增加一个出版社
class PublishView(ListAPIView, CreateAPIView):
queryset = models.Publish.objects.all() # 要序列化的数据
serializer_class = serializer.PublishModelSerializer # 要序列化的类
# 查询,删除,修改单个作者详情
class PublishSingleView(RetrieveDestroyAPIView, UpdateAPIView):
queryset = models.Publish.objects.all() # 要序列化的数据
serializer_class = serializer.PublishModelSerializer # 要序列化的类
使用视图集ViewSet,可以将一系列逻辑相关的动作放到一个类中:
-
list() 提供一组数据
-
retrieve() 提供单个数据
-
create() 创建数据
-
update() 保存数据
-
destory() 删除数据
ViewSet视图集类不再实现get()、post()等方法,而是实现动作 action 如 list() 、create() 等。
视图集只在使用as_view()方法的时候,才会将action动作与具体请求方式对应上。
常用的视图集父类
1) ViewSet
继承自APIView与ViewSetMixin,作用也与APIView基本类似,提供了身份认证、权限校验、流量管理等。
ViewSet主要通过继承ViewSetMixin来实现在调用as_view()时传入字典(如{‘get’:’list’})的映射处理工作。
在ViewSet中,没有提供任何动作action方法,需要我们自己实现action方法。
2)GenericViewSet
使用ViewSet通常并不方便,因为list、retrieve、create、update、destory等方法都需要自己编写,而这些方法与前面讲过的Mixin扩展类提供的方法同名,
所以我们可以通过继承Mixin扩展类来复用这些方法而无需自己编写。但是Mixin扩展类依赖与GenericAPIView,所以还需要继承GenericAPIView。
GenericViewSet就帮助我们完成了这样的继承工作,继承自GenericAPIView与ViewSetMixin,在实现了调用as_view()时传入字典(如{'get':'list'})
的映射处理工作的同时,还提供了GenericAPIView提供的基础方法,可以直接搭配Mixin扩展类使用。
3)ModelViewSet
继承自GenericViewSet,同时包括了ListModelMixin、RetrieveModelMixin、CreateModelMixin、UpdateModelMixin、DestoryModelMixin。
4)ReadOnlyModelViewSet
继承自GenericViewSet,同时包括了ListModelMixin、RetrieveModelMixin。
# 模型层models.py 和序列化类层 serializer.py参照上面即可
# 路由层 urls.py
from django.contrib import admin
from django.urls import path
from app01 import views
urlpatterns = [
path('admin/', admin.site.urls),
# 查询所有书籍,增加书籍
path('book/', views.BookView.as_view({'get': 'list', 'post': 'create'})),
# 查询,修改,删除单本书籍
path('book/<int:pk>/', views.BookView.as_view({'get': 'retrieve', 'put': 'update', 'delete': 'destroy'})),
path('publish/', views.PublishView.as_view({'get': 'lqz'})),
]
# 视图层 views.py
###目标:只写一个视图类,实现5个接口,最大的问题是,俩接口,都是get
####第五层:视图集
# ModelViewSet 5个接口都有
# ModelViewSet 继承了GenericViewSet和五个视图扩展类
# ReadOnlyModelViewSet:只有读的两个接口
from rest_framework.viewsets import ModelViewSet, ReadOnlyModelViewSet
from rest_framework.viewsets import ViewSet, GenericViewSet, ViewSetMixin
#ViewSet是:ViewSetMixin, views.APIView
#GenericViewSet是:ViewSetMixin, GenericAPIView
# ViewSetMixin:魔法
### 如果视图类继承了ViewSetMixin这个类,路由写法就需要path('book/', views.BookView.as_view({'get': 'list', 'post': 'create'})
'''
源码映射关系
{'get': 'list', 'post': 'create'}
'get' 'list'
for method, action in actions.items():
handler = getattr(self, action)
setattr(self, method, handler)
'''
###如果视图类继承了ViewSetMixin这个类,路由的as_view执行的是ViewSetMixin的as_view
# 查询所有书籍,增加一本书籍,查询、修改、删除单本书籍
class BookView(ModelViewSet):
queryset = models.Book.objects.all() # 要序列化的数据
serializer_class = serializer.BookModelSerializer # 要序列化的类
class PublishView(GenericViewSet): # 路由变了,其它都没变(注意继承的类,不要混淆了)
queryset = models.Publish.objects.all() # 要序列化的数据
serializer_class = serializer.PublishModelSerializer # 要序列化的类
def lqz(self,request): # 自定义lqz就是获取所有
qs = self.get_queryset()
ser = self.get_serializer(qs, many=True)
return Response(ser.data)
#两个基类 APIView GenericAPIView:有关数据库操作,queryset 和serializer_class #5个视图扩展类(rest_framework.mixins) CreateModelMixin:create方法创建一条 DestroyModelMixin:destory方法删除一条 ListModelMixin:list方法获取所有 RetrieveModelMixin:retrieve获取一条 UpdateModelMixin:update修改一条 #9个子类视图(rest_framework.generics) CreateAPIView:继承CreateModelMixin,GenericAPIView,有post方法,新增数据 DestroyAPIView:继承DestroyModelMixin,GenericAPIView,有delete方法,删除数据 ListAPIView:继承ListModelMixin,GenericAPIView,有get方法获取所有 UpdateAPIView:继承UpdateModelMixin,GenericAPIView,有put和patch方法,修改数据 RetrieveAPIView:继承RetrieveModelMixin,GenericAPIView,有get方法,获取一条 ListCreateAPIView:继承ListModelMixin,CreateModelMixin,GenericAPIView,有get获取所有,post方法新增 RetrieveDestroyAPIView:继承RetrieveModelMixin,DestroyModelMixin,GenericAPIView,有get方法获取一条,delete方法删除 RetrieveUpdateAPIView:继承RetrieveModelMixin,UpdateModelMixin,GenericAPIView,有get获取一条,put,patch修改 RetrieveUpdateDestroyAPIView:继承RetrieveModelMixin,UpdateModelMixin,DestroyModelMixin,GenericAPIView,有get获取一条,put,patch修改,delete删除 #视图集 ViewSetMixin:重写了as_view ViewSet: 继承ViewSetMixin和APIView GenericViewSet:继承ViewSetMixin, generics.GenericAPIView ModelViewSet:继承mixins.CreateModelMixin,mixins.RetrieveModelMixin,mixins.UpdateModelMixin,mixins.DestroyModelMixin,mixins.ListModelMixin,GenericViewSet ReadOnlyModelViewSet:继承mixins.RetrieveModelMixin,mixins.ListModelMixin,GenericViewSet
本篇知识回顾
1 序列化器源码
-many参数控制,在__new__中控制了对象的生成
-局部和全局钩子源码:is_valid--》找self.方法一定要从根上找
-source参数是如何执行的:‘publish.name’,'方法'
2 视图:
-2个视图基类
-5个视图扩展类
-9个视图子类
-视图集
-ViewSetMixin
-ViewSet, GenericViewSet
-ModelViewSet, ReadOnlyModelViewSet
3 视图类的继承原则
-如果不涉及数据库操作:继承APIView
-如果想让路由可以映射:继承ViewSetMixin
-如果不涉及数据库操作,又要让路由可以映射:继承ViewSet
-比如发邮件接口,发短信接口
-如果涉及到数据库操作:继承GenericAPIView
-如果想让路由可以映射:继承ViewSetMixin
-如果涉及数据库操作,又要让路由可以映射:继承GenericViewSet
-如果涉及数据库操作,又要让路由可以映射,还要能新增:继承GenericViewSet+CreateModelMixin或者继承ViewSetMixin+CreateAPIView
-如果只涉及到数据库操作和新增:继承CreateAPIView
-路由有映射,数据库操作,3个接口(查一个,删一个改一个)
4 ViewSetMixin:路由的写法就特殊了
5 类实例化,先执行了元类的__call__:调用了这个类的__new__,生成一个空对象,调用了类的__init__,完成了对象的初始化
6 对象()---->会触发类的 __call__
7 类()----->会触发类的类(元类)的__call__
如果顶上的图你还觉得不够清晰,那么这张绝对会让你眼花缭乱


浙公网安备 33010602011771号