Django框架深入了解_04(DRF之url控制、解析器、响应器、版本控制、分页)(二)

解析器介绍：

所谓解析器，就是前端传过来的数据，后端可以解析，从request.data中取出来，默认的解析器配置是三种编码格式都可以取

回到顶部

解析器的作用：

根据请求头(content-type)选择对应的解析器对请求体内容进行处理，有application/json，x-www-form-urlencoded，form-data等格式

设置解析器就可以控制前端传过来的数据类型进行限制，比如说我只能解析json格式的数据，那么前端必须给我传json数据我才能拿到

三种编码格式：urlencoded，formdata，json
-urlencoded：在body体中的格式是：name=xxx&age=18&wife=liyitong
-formdata:在body体中的格式数据部分跟文件部分有区分
-json格式：在body体中就是json格式

解析器的使用：

(实际就是通过配置解析器，让后端只接收某一种格式的请求数据类型，这样后端只能解析该类型数据，其它类型的请求都会无效，当然设置一种也可以设置多种)

局部使用：

测试：

全局使用：
先了解一下默认解析三种格式的设置代码：
全局设置：

--------------------------------------------------------------------
注：如果你对python感兴趣，我这有个学习Python基地，里面有很多学习资料，感兴趣的+Q群：895817687
--------------------------------------------------------------------在setting中配置：REST_FRAMEWORK = {"DEFAULT_PARSER_CLASSES":['rest_framework.parsers.JSONParser',]}

三、响应器：

回到顶部
响应器的作用：
根据用户请求URL 或用户可接受的类型，筛选出合适的渲染组件。

回到顶部
响应器的使用：

-from rest_framework.renderers import JSONRenderer,BrowsableAPIRenderer
-不用动，就用全局配置即可
-全局使用：
-在setting中配置
'DEFAULT_RENDERER_CLASSES': [
'rest_framework.renderers.JSONRenderer',
]
-局部使用：
-在视图类中配置：
renderer_classes = [JSONRenderer, BrowsableAPIRenderer]

响应器的内置渲染器：
显示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=adminhttp://127.0.0.1:8000/test.adminhttp://127.0.0.1:8000/test/

form表单方式：HTMLFormRenderer

    访问URL：http://127.0.0.1:8000/test/?format=formhttp://127.0.0.1:8000/test.formhttp://127.0.0.1:8000/test/

四、版本控制

restful规范里，提出过版本的概念，也就是说版本控制就是相对于接口而言，它有多个版本，就好像应用程序、手机app都会更新版本一样，会修改更新接口文件，这时候就不能在原接口进行修改更新，应该另起一个接口作为版本2(假设为v2)来提供给用户使用，原来的版本可能是v1，那么v1和v2版本提供给外界的控制，就是版本控制。

通过路由拼接版本号或者放入请求头中的途径来获取对应版本号的接口，进行请求。

from rest_framework.versioning import QueryParameterVersioning,AcceptHeaderVersioning,NamespaceVersioning,URLPathVersioning#基于url的get传参方式：QueryParameterVersioning------>如：/users?version=v1
#基于url的正则方式：URLPathVersioning------>/v1/users/
#基于 accept 请求头方式：AcceptHeaderVersioning------>Accept: application/json; version=1.0
#基于主机名方法：HostNameVersioning------>v1.example.com
#基于django路由系统的namespace：NamespaceVersioning------>example.com/v1/users/

全局使用：

    -在setting中配置：    'DEFAULT_VERSIONING_CLASS':'rest_framework.versioning.URLPathVersioning','DEFAULT_VERSION': 'v1',  # 默认版本(从request对象里取不到，显示的默认值)'ALLOWED_VERSIONS': ['v1', 'v2'],  # 允许的版本'VERSION_PARAM': 'version'  # URL中获取值的key

    -路由需要修改-url(r'^(?P<version>[v1|v2]+)/test/', views.Test.as_view()),

局部使用：

在视图类中就可以通过：request.version取出当前访问哪个版本，相应的取执行相应版本的代码

回到顶部

五、DRF分页器

前戏：批量创建多条数据用于测试分页：

url(r'^pagetest/', views.PaginationTest.as_view()),

# views.pyclass PaginationTest(APIView):# 批量创建publish记录，用于测试分页def post(self,request):pub_l = []for i in range(1000):pub_l.append(models.Publish(name='出版社[%s]' % (i+1), addr='地址[%s]' % (i+1)))models.Publish.objects.bulk_create(pub_l)return Response('批量创建成功')

常规分页

url(r’^pagetest/’, views.PaginationTest.as_view()),

# 视图类from rest_framework.pagination import PageNumberPagination,LimitOffsetPagination,CursorPagination
from app01.MySer import PublishSerclass PaginationTest(APIView):# 批量创建publish记录，用于测试分页def post(self,request):pub_l = []for i in range(1000):pub_l.append(models.Publish(name='出版社[%s]' % (i+1), addr='地址[%s]' % (i+1)))models.Publish.objects.bulk_create(pub_l)return Response('批量创建成功')def get(self, request, *args, **kwargs):# 拿到所有数据publish_list = models.Publish.objects.all()# 实例化出page对象page = PageNumberPagination()
# ================ page相关参数配置开始 ================ ## # 每页显示10条，也可以在settings.py中添加全局配置('PAGE_SIZE': 10 )page.page_size = 10# # 设置每页条数的拼接key(默认为size)page.page_size_query_param = 'size0'# # 控制每页最大显示条数：(这个控制仅限制于路径后拼接设置size0=1000后，对其进行限制)page.max_page_size = 30# # 设置定位的页数的拼接key(默认是page)page.page_query_param = 'page0'
# ================ page相关参数配置结束 ================ ## 对数据进行分页处理：ret_page = page.paginate_queryset(publish_list, request, self)# 序列化pub_ser = PublishSer(instance=ret_page, many=True)return Response(pub_ser.data)

也可以在全局配置每页显示条数：
测试：

偏移分页

偏移分页与普通分页使用基本相同，类不同，配置的参数名称不同

# 偏移分页：def get(self, request, *args, **kwargs):# 拿到所有数据publish_list = models.Publish.objects.all()# 实例化出page对象page = LimitOffsetPagination()
# ================ page相关参数进行配置开始 ================ ## # 从标杆位置往后取几个，比如指定取10个page.default_limit = 10# # 拼接key值自定义# 拿几条记录的key值自定义page.limit_query_param = 'limit0'# 标杆值(起始位置)，从设置的offset0值那个位置往后拿limit0值的记录page.offset_query_param = 'offset0'# # 设置最大取10条page.max_limit = 20
# ================ page相关参数进行配置结束 ================ ## 对数据进行分页处理：ret_page = page.paginate_queryset(publish_list, request, self)# 序列化pub_ser = PublishSer(instance=ret_page, many=True)return Response(pub_ser.data)

补充：get_paginated_response的使用

将return Response(pub_ser.data) 替换成 return page.get_paginated_response(pub_ser.data)
作用测试图：(此方法主要用于游标分页中，因为游标分页并不能指定第几页第几页，只有上一页和下一页)
cursor游标分页

# 游标分页：def get(self, request, *args, **kwargs):# 拿到所有数据publish_list = models.Publish.objects.all()# 实例化出page对象page = CursorPagination()# ================ page相关参数进行配置开始 ================ ## # 每页显示条数page.page_size = 5# # 查询的key值自定义，默认是cursor，无需更改page.cursor_query_param = 'cursor'# 游标分页会将记录进行排序，然后根据排序的记录进行分页显示，设置排序依据page.ordering = 'id'# ================ page相关参数进行配置结束 ================ ## 对数据进行分页处理：ret_page = page.paginate_queryset(publish_list, request, self)# 序列化pub_ser = PublishSer(instance=ret_page, many=True)# 如果使用Response返回数据，就不知道怎么定位上一页和下一页了# return Response(pub_ser.data)# 使用get_paginated_response，返回结果return page.get_paginated_response(pub_ser.data)

游标分页的cursor后面的值我们是不知道的，所以拼不出来：

游标分页特点：它是一种加密分页，只能看上一页和下一页，速度快