上面的mixins、generics都是rest_framework里的模块,我们可以继承其中的某些类,达到代码量减少的效果,这里充分体现出了面向对象的继承
一、mixins模块
mixins : from rest_framework import mixins #导入方式
存放一些增删改查的一些类
CreateModelMixin,ListModelMixin,RetrieveModelMixin,UpdateModelMixin,DestroyModelMixin
二、generics模块
generics: from rest_framework import generics # 导入方式
首先mixins文件中就是一个一个类,写着某些方法,但是你想用于CBV,必须继承Django的View,这里我们用rest_framework则需继承apiView,
这个py文件里定义了许多类,但是有一个最基本的类GenericAPIView(views.APIView),里面其他的类都会继承这个类,因为这个类定义的一些
方法是专门提供于mixins文件里的类的,再看其他generics模块里的其他类,你会发现那么类全是基于mixins模块和GenericAPIView之间的组
合,那么你想用rest_framework提供给我们的简便方法,那么必须要继承GenericAPIView,和mixins模块里的类。
三、通过一个简单的例子,顺带写mixins,generics的用处
eg:写一个接口,获取到所有书籍的数据,这里我只写视图类里的代码
from rest_framework.generics import GenericAPIView
from rest_framework.mixins import ListModelMixin
from app import models
from write_serializers import BooksSerializers
class Books(GenericAPIView,ListModelMixin):
queryset = models.Book.objects.all()
serializer_class = BooksSerializers
def get(self,request,*args,**kwargs):
return self.list(request, *args, **kwargs)
好了,上面就是我们通过rest_framework提供的方法之一,完成了一个简单的接口,
来一个GET请求,便会执行这个视图类的get方法,最终返回了self.list方法的执行结果,那我们去看看list方法是怎么执行的,
那么我们顺着继承的基类去找list方法,基于深度查询,我们找完GenericAPIView继承的基类们,并没有找到,那么我们去ListModelMixin
这个类中找,这个类很简单,就写了一个list方法。
先看list方法,里面有self.filter_queryset(),self.paginate_queryset(),self.get_serializer()等等方法,很明显视图类中
没有写这些方法,ListModelMixin这个类里也没有,那么肯定在GenericAPIView,所以我之前就说了,GenericAPIView类是为mixins模块里
类提供方法的,所以二者必须一起使用。
分析1: queryset = self.filter_queryset(self.get_queryset())
queryset = self.filter_queryset(self.get_queryset())
这行代码整体意思应该能看得懂吧,filter_queryset这个方法的返回值赋值给queryset,而filter_queryset的参数是get_queryset
的返回值,那么我们先去看filter_queryset这方法的参数是什么,也就是get_queryset的返回值
首先,断言self.queryset这个属性的布尔值必须是True的,不是的话便会抛异常,我们先看GenericAPIView类中有没有这个属性(这并不是
属性的查找顺序),我们可以找到queryset = None,这样的话,我们再写视图类的话(前提是继承了这个类),没有写queryset这个属性或者值
为False,那么便会出错,所以queryset这个属性必须在视图类中为True。
根据这个我想到一点分享下,你可以用断言这种方法,指定它的子类必须要有该属性且值为True,对吧,方法也是一样,定义一个方法,在该方法
内写一个raise异常,rest_framework里很多就是通过这种方法,比如rest_framework.throttling.BaseThrottle这个类里的方法为allow_request。
接着上面继续,能走到return,就代表self.queryset肯定为True吧,前面的逻辑处理就不多说了。从现在看的话,那么这个queryset可以为
任何值吧,参数的值是什么了,继续看self.filter_queryset()这个方法的返回值
这个你可以看它的注释,大概意思是将传来的参数queryset,再过滤一遍,self.filter_backends它的值为None,前提不进行任何设置,而
这个设置是在settings文件里的REST_FRAMEWORK,也就是之前进行全局设置登陆认证,权限认证的地方。不进行设置的话,还是会返回之前的
传进来的参数。最终赋值给queryset
分析2:page = self.paginate_queryset(queryset)
page = self.paginate_queryset(queryset)
参数我们知道是什么,直接看paginate_queryset方法吧
self.paginator它是被装饰成属性的方法,self.paginator它的返回不是None就是一个对象(这个对象是进行分页的),上面我们列举的例子
视图类中并没有写pagination_class这个属性,那么就会去找到默认pagination_class,默认值为None,如果你再视图类中写了该属性,
值应该是是一个类,最后会返回这个类的对象回去。如果self.paginator为True,那么self.paginator就是一个对象了,就会执行该对象
下面的paginate_queryset这个方法。
提醒:不管self.paginator这个对象是自定义的类产生的,还是rest_framework自带的,那么肯定会有paginate_queryset方法。它的返
回值肯定是某一页的对象列表。
分析3:serializer = self.get_serializer(queryset, many=True)
不管有没有进行分页,都会执行get_serializer这个方法,返回值为serializer,最终返回serializer.data
不难可以看出,我们写的视图类中必须要有serializer_class属性,且有值,这个和前面queryset这属性是一样的。最终返回序列化的对象
总结下:我们写的视图类必须要有serializer_class --->> 写序列化类
queryset ---->> queryset的对象
可有可无看需求:pagination_class ---->> 进行分页的类
在GenericAPIView还有一个方法再说下get_object方法,这个方法在RetrieveModelMixin,UpdateModelMixin,DestroyModelMixin都用上了,看方法名就差不多知道,返回一个对象。
分析1: queryset = self.filter_queryset(self.get_queryset()) 这个跟之前分析的一样,(见上面的分析1)
分析2: lookup_url_kwarg = self.lookup_url_kwarg or self.lookup_field
这个其实没啥好说的,就说一点or,and的用法,我博客也写了这个,可以去看看
分析3: lookup_url_kwarg in self.kwargs
这句话很简单,判断lookup_url_kwarg这个值在不在self.kwargs这个容器里,但是这个self.kwargs到底是什么呢?self就是
当前的视图类的对象,它有kwargs这个属性?
先自己思考下,我在后面再写出来
分析4: obj = get_object_or_404(queryset, **filter_kwargs)
首先我们要弄清传的参数的是什么,filter_kwargs是一个字典({'pk':1}),那么**filter_kwargs就是pk=1,queryset这个就不
用在介绍了,看看这个方法get_object_or_404,
利用get方法,如果get里的参数不能找到唯一的一条数据的话,便会抛异常,通过捕捉异常去处理。程序顺利进行的话,那么返回的就是get
到的对象。
注意:属性的查看顺序,不要直接ctrl+鼠标左键,上面这个方法我就是直接ctrl+左键点进去的,虽然最后还是执行的这个方法,但是这是
误打误撞,在generics这个模块里,就有get_object_or_404方法。所以先去generics这个模块里get_object_or_404,再去
上面的get_object_or_404方法。。。
分析5: self.check_object_permissions(self.request, obj)
上面这行代码其实很熟悉,这个和之前进行用户权限认证差不多一样,不一样的是对谁进行权限认证,一个是用户,一个是一条记录(数据
库),也就是这里的obj。
permission就是一个进行权限认证的对象,那么该对象必须要有has_object_permission方法,进行一系列判断,权限许可的话,
就返回True,不许可的话,返回False。光这么说,也不知道用在哪个地方,我想了个例子:首先obj就是我们从数据库拿到的数据
(对象),其实数据也分等级,也有不同权限的数据,我们可以再根据判断,再进行数据的返回。
提醒:这里我们是继承了GenericAPIView,它里面的get_object里做的权限认证,我们不继承GenericAPIView,也一样可以去
调用这个方法。但check_object_permissions方法是rest_framework提供的。
对于get_object方法的分析差不多了,再讲上面的分析3,self.kwargs哪里来的。
我们回到APIView中的dispatch方法就知道了
generics这个模块里还有其他类,可以去看看,很简单就是类的继承问题。
好了,这块就写到这里了
0