解析器
1.json解析器
发一个json格式的post请求。
后台打印:
request_data---> {'title': '北京折叠'}
request.POST---> <QueryDict: {}>
2.urlencode解析器
request_data---> <QueryDict: {'title': ['北京'], 'price': ['']}>
request.POST---> <QueryDict: {'title': ['北京'], 'price': ['']}>
rest-framework默认支持的有3种解析器,json,form,文件上传。而Django原生只支持form的解析,不支持json的解析。
源码:
JSON解析器类:
class JSONParser(BaseParser):
"""
Parses JSON-serialized data.
"""
media_type = 'application/json'
renderer_class = renderers.JSONRenderer
strict = api_settings.STRICT_JSON def parse(self, stream, media_type=None, parser_context=None):
"""
Parses the incoming bytestream as JSON and returns the resulting data.
"""
parser_context = parser_context or {}
encoding = parser_context.get('encoding', settings.DEFAULT_CHARSET) try:
decoded_stream = codecs.getreader(encoding)(stream)
parse_constant = json.strict_constant if self.strict else None
return json.load(decoded_stream, parse_constant=parse_constant)
except ValueError as exc:
raise ParseError('JSON parse error - %s' % six.text_type(exc))
form解析器类:
class FormParser(BaseParser):
"""
Parser for form data.
"""
media_type = 'application/x-www-form-urlencoded' def parse(self, stream, media_type=None, parser_context=None):
"""
Parses the incoming bytestream as a URL encoded form,
and returns the resulting QueryDict.
"""
parser_context = parser_context or {}
encoding = parser_context.get('encoding', settings.DEFAULT_CHARSET)
data = QueryDict(stream.read(), encoding=encoding)
return data
文件上传类:
class MultiPartParser(BaseParser):
"""
Parser for multipart form data, which may include file data.
"""
media_type = 'multipart/form-data' def parse(self, stream, media_type=None, parser_context=None):
"""
Parses the incoming bytestream as a multipart encoded form,
and returns a DataAndFiles object. `.data` will be a `QueryDict` containing all the form parameters.
`.files` will be a `QueryDict` containing all the form files.
"""
parser_context = parser_context or {}
request = parser_context['request']
encoding = parser_context.get('encoding', settings.DEFAULT_CHARSET)
meta = request.META.copy()
meta['CONTENT_TYPE'] = media_type
upload_handlers = request.upload_handlers try:
parser = DjangoMultiPartParser(meta, stream, upload_handlers, encoding)
data, files = parser.parse()
return DataAndFiles(data, files)
except MultiPartParserError as exc:
raise ParseError('Multipart form parse error - %s' % six.text_type(exc))
URL控制
1.因为每次url都需要写下面的2条线,导致代码冗余。
# url(r'authors/$', views.AuthorModelView.as_view({"get":"list","post":"create"}),name="authors"),
# url(r'authors/(?P<pk>\d+)/$', views.AuthorModelView.as_view({"get":"retrieve","put":"update","delete":"destroy"}),name="authordetail"),
2.使用rest-framework提供的:
from django.conf.urls import url,include
from app01 import views from rest_framework import routers
routers=routers.DefaultRouter()
routers.register("authors",views.AuthorModelView)
url中需要加这一句即可:
url(r'',include(routers.urls)),
以后每一个表,注册一下即可,前面的是url的前缀,后面是对应的视图类。
测试结果以及自动生成的url路径如下图:(可以直接.json取到结果)
生成的URL:
分页
1.基本分页器:
from rest_framework.pagination import PageNumberPagination
#自己写一个继承分页器,然后自己设置
class MyPageNumberPagination(PageNumberPagination):
page_size = 2 #每个页面显示多少数据
page_query_param = "page" #?page 的名字,默认"page",可以改其他
page_size_query_param = "size" #临时的一个分页数目,虽然最多2条,但是可以临时扩大每页显示的数据数量
max_page_size = 3 #虽然临时的可以调,但不能无限大,做一个最大临时限制。 class BookView(APIView):
# authentication_classes = [TokenAuth]
def get(self,request):
print(request.user) #token_obj.user.name
print(request.auth) #token_obj.token
book_list=Book.objects.all()
#加入分页
pnp=MyPageNumberPagination() #分页器实例对象
books_page=pnp.paginate_queryset(book_list,request,self) #传入数据 bs2=BookModelSerializers(books_page,many=True,context={'request': request}) #将分好的数据进行序列化并展示
return Response(bs2.data)
2.偏移分页器(很少用到):
from rest_framework.pagination import LimitOffsetPagination
和上面一模一样,只是加了一个offset的偏移参数。
3.对于高度封装的视图类怎么使用分页器:
from rest_framework import viewsets
class AuthorModelView(viewsets.ModelViewSet):
queryset=Author.objects.all()
serializer_class=AuthorModelSerializers
pagination_class = MyPageNumberPagination
因为这个作者的视图进行了高度的封装,显然重写list方法并且进行分页展示非常的麻烦,那么使用一个
pagination_class =你自己继承分页器并且定制好的分页器类即可完成分页。
4.全局配置分页数目:
settings中进行配置。
REST_FRAMEWORK={
# "DEFAULT_AUTHENTICATION_CLASSES":["app01.utils.TokenAuth",],
# "DEFAULT_PERMISSION_CLASSES":["app01.utils.SVIPPermission",],
"PAGE_SIZE":3,
}
响应器
from rest_framework.response import Response
针对rest-frarmwork返回的数据进行各种操作,如果使用浏览器,那么响应器会渲染一个页面出来提供各种操作,如果使用postman,只返回一堆数据。
具体如下图:
postman:
浏览器上:
这个页面可进行option,delete,put操作。
针对所有数据,下面可以进行get和post请求。
渲染器
这里可以使用Json的渲染器
也可以是这种页面形式的(用的少)
全局配置渲染器:
版本控制
1.先导入
from rest_framework.versioning import QueryParameterVersioning,URLPathVersioning
2.在APIView中
3.局部配置
4.全局配置
settings中配置:
REST_FRAMEWORK={
# "DEFAULT_AUTHENTICATION_CLASSES":["app01.utils.TokenAuth",],
# "DEFAULT_PERMISSION_CLASSES":["app01.utils.SVIPPermission",],
"PAGE_SIZE":1,
# 配置全局渲染器(Json格式的,和那种页面形式的)
# 'DEFAULT_RENDERER_CLASSES':['rest_framework.renderers.JSONRenderer',]
'DEFAULT_VERSION_CLASS':'rest_framework.versioning.QueryParameterVersioning',#使用哪种版本控制
'ALLOWED_VERSIONS':['v1','v2'], #允许的版本
'VERSION_PARAM':'version', #参数
'DEFAULT_VERSION':'v1', #默认版本 }
5.对于两种不同的配置要说的是。
(1)对于QueryParameterVersioning这种
在url后缀加上版本。
后端通过request.version就可以拿到这个版本
(2)对于URLPathVersioning(推荐使用)
这个实在URL里面直接写。
首先要在url做一个配置。
url(r'^(?P<version>\w+)/books/$', views.BookView.as_view(),name="books"),
get请求参数拿到这个version。
def get(self,request,*args,**kwargs):
print("version",request.version)
#print(request.user) #token_obj.user.name
#print(request.auth) #token_obj.token
book_list=Book.objects.all()
#加入分页
pnp=MyPageNumberPagination()
books_page=pnp.paginate_queryset(book_list,request,self) # bs=BookSerializers(book_list,many=True)
bs2=BookModelSerializers(books_page,many=True,context={'request': request})
# return Response(bs.data)
return Response(bs2.data)
前端页面的URL是
因为在全局做了允许配置,所以只能是v1,v2如果输入其他会报错。
这就是版本控制。