REST framework 渲染模块

作用

根据 用户请求URL 或 用户可接受的类型，筛选出合适的 渲染组件。(页面 postman)

内置渲染器

from rest_framework.renderers import JSONRenderer
from rest_framework.renderers import BrowsableAPIRenderer
from rest_framework.renderers import AdminRenderer
from rest_framework.renderers import HTMLFormRenderer

显示json格式：JSONRenderer

访问URL：

• http://127.0.0.1:8000/test/?format=json

• http://127.0.0.1:8000/test.json

• http://127.0.0.1:8000/test/

默认显示格式：BrowsableAPIRenderer（可以修改它的html文件）

访问URL：

• http://127.0.0.1:8000/test/?format=api
• http://127.0.0.1:8000/test.api
• http://127.0.0.1:8000/test/

表格方式：AdminRenderer

访问URL：

• http://127.0.0.1:8000/test/?format=admin
• http://127.0.0.1:8000/test.admin
• http://127.0.0.1:8000/test/

form表单方式：HTMLFormRenderer

访问URL：

• http://127.0.0.1:8000/test/?format=form
• http://127.0.0.1:8000/test.form
• http://127.0.0.1:8000/test/

源码分析

源码入口
APIView类的dispatch方法中：self.response = self.finalize_response(request, response, *args, **kwargs)

源码分析

# 最后解析reponse对象数据
self.response = self.finalize_response(request, response, *args, **kwargs) 点进去
​
# 拿到运行的解析类的对象们
neg = self.perform_content_negotiation(request, force=True) 点进去
​
# 获得解析类对象
renderers = self.get_renderers() 点进去
​
# 从视图类中得到renderer_classes请求类，如何实例化一个个对象形参解析类对象列表
return [renderer() for renderer in self.renderer_classes]
​
​
# 重点：self.renderer_classes获取renderer_classes的顺序
#   自己视图类的类属性(局部配置) => 
#   APIView类的类属性设置 => 
#   自己配置文件的DEFAULT_RENDERER_CLASSES(全局配置) => 
#   drf配置文件的DEFAULT_RENDERER_CLASSES

使用

• 全局配置 所有视图类统一处理

在项目的settings.py中

REST_FRAMEWORK = {
    'DEFAULT_RENDERER_CLASSES': ['rest_framework.renderers.JSONRenderer']
}

• 局部配置 某一个或一些实体类单独处理

在views.py视图类中提供对应的类属性

from rest_framework.renderers import JSONRenderer
class Test2(APIView):
    # 局部配置
    renderer_classes = [JSONRenderer]  # 所在类局部配置
    def get(self, request, *args, **kwargs):
        return Response('drf get ok 2')
​
    def post(self, request, *args, **kwargs):
        return Response('drf post ok 2')

在setting.py中配置REST_FRAMEWORK，完成的是全局配置，所有接口统一处理
如果只有部分接口特殊化，可以完成 - 局部配置