解析器介绍:
所谓解析器,就是前端传过来的数据,后端可以解析,从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=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/
四、版本控制
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.py
class 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 PublishSer
class 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后面的值我们是不知道的,所以拼不出来:
游标分页特点:它是一种加密分页,只能看上一页和下一页,速度快