目录
DRF的请求响应组件
下面我们介绍DRF的请求响应组件,主要包括三种,即请求模块,响应模块和解析模块.另外还有两个常用的相关模块,即渲染模块和异常模块.我们分别从模块的使用和源码分析来介绍,这里我们安装的DRF版本是最原始的0.1.0,所以下面的源码都是以这个版本为准的.
请求模块(request)
概念
drf的请求模块其实是在wsgi的request基础上再次封装,wsgi中的request模块是作为drf里面新的request模块的一个属性,名为_request,并对其完全兼容,且对于数据的解析鼓风机啊规范化,所有url拼接的参数都存放在了query_params中,而所有的数据包数据都被解析并存放在了data中,且query_params和data都是QueryDict类型,可以通过后缀.dict()来转化为原生的dict类型.
drf的request从根本上来说是基于CBV的一种结构,并在其上面做了各种扩展,而CBV源码中最关键的就是as_view方法和dispatch方法,drf中同样有.
request源码简单分析
# /rest_framework/views.py/APIView(View)
# 上面地址可以通过下面的导入语句,然后按住ctrl+鼠标左键点击APIView进入
from rest_framework.views import APIView
# 121行到144行,是as_view的源码,一方面,这个源码的父类是继承于View,也就是wsgi最原始的View,所以有些方法是直接用的View中的.
# 我们在as_view的源码中,只需要注意两点,
@classmethod
def as_view(cls, **initkwargs):
view = super().as_view(**initkwargs) # 该行是直接调用的其父类,也就是wsgi的View类来实现生成一个新的view,相当于重写了as_view方法,其主体逻辑还是View里面的as_view()
return csrf_exempt(view) # 这里返回的是局部禁用的csrf认证的view视图函数,csrf_exempt就是可以局部禁用csrf的方法
# 484到511行,是DRF重写的dispatch(),其内部还是原本View内部dispatch方法,不过另外封装了两个功能,如下
def dispatch(self, request, *args, **kwargs):
self.args = args
self.kwargs = kwargs
request = self.initialize_request(request, *args, **kwargs) # 这里就是DRF重写dispatch中对request的第二次封装,initialize_request里面是走的Request的内部__init__方法, self._request = request
self.request = request
self.headers = self.default_response_headers
try: # try里面的内容和原装View里面dispatch的方法完全一样,即通过__getattr__方法,先从self._request反射取属性,没取到的话再从drf的request中取
self.initial(request, *args, **kwargs)
if request.method.lower() in self.http_method_names:
handler = getattr(self, request.method.lower(),
self.http_method_not_allowed)
else:
handler = self.http_method_not_allowed
response = handler(request, *args, **kwargs)
except Exception as exc:
response = self.handle_exception(exc)
self.response = self.finalize_response(request, response, *args, **kwargs) # 这里是对于response的第二次封装,也就是对于响应模块的第二次封装
return self.response
响应模块(response)
概念
响应模块的主要作用就是根据用户发送来的URL来筛选出对应的渲染组件,然后将内容渲染好发给用户.
现在的主流框架所包含的内置渲染器大多包含三种
- JSONRenderer:显示json格式
- BrowsableAPIRenderer:默认显示格式
- HTMLFormRenderer:显示form表单格式
Response类生成对象需要参数,以及生成的对象可以使用一些属性
- 参数: Response(data = 响应的数据,status = 响应的网络状态码, headers = 想通过响应头再携带部分信息给前端)
- 属性: response.data response.status_code response.status_text
使用方法
响应模块的使用方法常有两种,局部使用和全局使用
局部使用
# 应用名/views.py
from rest_framework.renderers import JSONRenderer, HTMLFormRenderer, BrowsableAPIRenderer
from rest_framework.views import APIView
class BookDetailView(AIPView):
renderer_classes = [JSONRenderer,HTMLFormRenderer, BrowsableAPIRenderer] # 括号内即是后端允许前端的渲染格式
def get(self,request,pk):
return Response(bs.data)
全局使用
全局使用的话需要在settings.py里面配置选项
# settings.py
REST_FRAMEWORK = {
'DEFAULT_RENDERER_CLASSES':[
'rest_framework.renderers.JSONRenderer'
]
}
# 在全局配置之后就不用再view视图函数里面配置了,全局的组件都会适用这个规则
response源码简单分析:
# response的源码主要在Response类的__init__方法中
# 可以从下面的Response里面点进去Response方法
from rest_framework.response import Response
# response.py,14到47行,
class Response(SimpleTemplateResponse):
def __init__(self, data=None, status=None,
template_name=None, headers=None,
exception=False, content_type=None): # 这里就是对response的初始化
super().__init__(None, status=status)
self.data = data # 给当前响应赋新属性,包括data,content_type等
self.template_name = template_name
self.exception = exception
self.content_type = content_type
解析模块(parse)
概念
解析模块的主要作用就是根据前端发来的请求头(content-type)的不同选择对应的解析器对请求内容进行处理,常用的请求头有application/json,x-www-form-urlencoded,form-data等格式.
使用方法
全局使用
全局使用解析器非常简单,直接在settings.py里面配置就行了
# settings.py
REST_FRAMEWORK = {
'DEFAULT_PARSER_CLASSES':[
'rest_framework.parsers.JSONParser', # 允许json格式
# 'rest_framework.parsers.FormParser', # 允许form-urlencoded
# 'rest_framework.parsers.MultiPartParser', # 允许form-data格式
]
}
# 上面配置完之后就可以在全局适用解析模块
# urls.py
from django.conf.urls import url
from api import views
urlpatterns = [
url(r'^test/', views.TestView.as_view())
]
# views.py
class TestView(APIView):
def post(self, request, *args, **kwargs):
print(request.content_type) # 因为全局配置我们只有JSONParser,所以发送来的请求只有content_type为JSONParser时才能正确解析,request.POST里面才会有值.
print(request.data)
print(request.POST)
print(request.FILES)
return Response('POST请求,响应内容')
def put(self, request, *args, **kwargs):
return Response('PUT请求,响应内容')
局部使用
局部使用也非常简单,只需要在需要使用解析器的地方加上parser_classes=[]就行了.
# urls.py
from django.conf.urls import url
from api import views
urlpatterns = [
url(r'^test/', views.TestView.as_view())
]
# views.py
from rest_framework.views import APIView
from rest_framework.response import Response
from api import models
from rest_framework.parsers import JSONParser,FormParser,MultiPartParser
class TestView(APIView):
parser_classes = [JSONParser,FormParser,MultiPartParser] # 这里就是局部配置的配置项,括号里有的数据格式允许解析和传送,没有的数据将会被拒绝
def post(self, request, *args, **kwargs):
print(request.content_type)
print(request.data)
print(request.POST)
print(request.FILES)
return Response('POST请求,响应内容')
def put(self, request, *args, **kwargs):
return Response('PUT请求,响应内容')
parse源码分析
# parse的源码存在于dispatch的initialize_request方法中
# /rest_framework/views.py
# 381到393行
def initialize_request(self, request, *args, **kwargs):
parser_context = self.get_parser_context(request) #这里提供要解析的数据
return Request(
request,
parsers=self.get_parsers(), #这里提供要解析的类对象
authenticators=self.get_authenticators(),
negotiator=self.get_content_negotiator(),
parser_context=parser_context
)