DRF请求流程及主要模块分析
Django中CBV请求生命周期
- 请求来时,经过路由,在url.py中由url(r'^books/', views.Book.as_view())完成路由匹配
- url会调用as_view()的返回值(视图函数view)
- 调用dispatch()完成请求分发
- 视图类的具体视图方法处理请求
- 返回给前台
drf前期准备
1. 在views.py中视图类继承drf的APIView类
from rest_framework.views import APIView
class BookAPIView(APIView):
pass
2. drf的as_view()方法
-
返回视图函数时,局部禁用了csrf认证:csrf_exempt(view)
-
请求分发:dispatch()
-
在分发前,二次封装request
self.initialize_request(request, *arg, **kwargs)
-
三大认证:
self.initial(request, *args, **kwargs)
-
-
在视图方法处理完请求后
-
异常处理:
self.handle_exception(exc)
-
二次封装response:
-
self.finalize_response(request, response, *args, **args)
-
-
drf的源码主要部分可从下面入口查看:
rest_framework.view中的APIView类的dispatch()方法
drf主要模块分析
1. 请求模块
- rest_framework的request对wsgi的request做了二次封装
- self.initialize_request(request, *arg, **kwargs)
- 兼容wsgi中request的方法(self._request = request, 先从self._request中取值)
- 在封装时,解析了request中的数据,将拼接参数放入query_params属性中,将数据包参数放入data属性中
2. 渲染模块
对全部和局部配置渲染方式
1、二次处理响应对象:APIView的dispatch方法 - self.finalize_response(request, response, *args, **kwargs)
2、获取渲染类对象:进入finalize_response方法 - self.perform_content_negotiation(request, force=True)
3、从配置文件中得到渲染类对象:perform_content_negotiation -> self.get_renderers() -> [renderer() for renderer in self.renderer_classes] 局部配置:
# views.py
class BookAPIView(APIView):
# 两种渲染方式: JSONRenderer, BrowsableAPIRenderer
renderer_classes = []
全局配置:
开发一般只配置json
# settings.py
REST_FRAMEWORK = {
'DEFAULT_RENDERER_CLASSES' = [
'rest_framework.renderers.JSONRenderer'
],
}
3. 解析模块
服务的对象是数据包数据
1、APIView的dispatch方法:self.initialize_request(request, *args, **kwargs)内部还提供了数据解析
2、self.get_parser_context(request)提供要解析的数据,self.get_parsers()提供解析的类对象(内部从配置中找解析类)
局部配置:可以在视图类中通过parser_classes类属性对该视图的数据包解析做配置
# views.py
class BookAPIView(APIView):
# 三种解析方式:application/json, urlencoded, form-data
parser_classes = [JSONParser, MultiPartParser, FormParser]
全局配置:可以在项目的配置文件的drf配置中通过DEFAULT_PARSER_CLASSES对该视图的数据包解析做配置
# settings.py
REST_FRAMEWORK = {
'DEFAULT_PARSER_CLASSES' = [
'rest_framework.parsers.JSONParser',
'rest_framework.parsers.FormParser',
'rest_framework.parsers.MultiPartParser'
],
}
4. 异常模块
源码分析
1、在APIView的dispatch方法中,有一个超大的try...except...,将代码运行异常都交给异常处理模块处理self.handle_exception(exc)
2、从配置中映射出配置处理异常的函数(自定义异常模块就是自定义配置指向自己的函数):self.get_exception_handler()
3、异常函数exception_handler(exc, context)处理异常,就会走自己的: 先交给系统处理(客户端的异常),系统没处理(服务器异常),再自己处理
1、在settings的drf配置中配置EXCEPTION_HANDLER,指向自定义的exception_handler函数
2、drf出现异常了,都会回调exception_handler函数,携带 异常对象和异常相关信息内容, 在exception_handler函数完成异常信息的返回以及异常信息的logging日志
# settings.py
REST_FRAMEWORK = {
'EXCEPTION_HANDLER': 'api.utils.exception_handler',
}
5. 响应模块
Response类生成对象需要的参数,以及Response类的对象可以使用的属性
1、参数:Response(data=响应的数据, status=响应的网络状态码, headers=想通过响应头再携带部分信息给前端)
2、属性:response.data response.status_code response.status_text
源码:Response类的__init__方法