drf除了在数据序列化部分简写代码以外,在请求和响应也简化了一些步骤
rest_framework.response.Request:通过parser解析类 识别客户端请求头中的Content-Type来完成数据转换成->类字典(QueryDict,字典的子类)
rest_framework.response.Response:通过renderer渲染类 识别客户端请求头的"Accept"来提取客户端期望的返回数据格式,-> 转换成客户端的期望格式数据
一、请求Request
rest_framework.response.Request
1、常用属性
1)data
request.data
返回解析之后的请求体数据。类似于Django中标准的request.POST
和 request.FILES, request.body
属性,但提供如下特性:
包含了解析之后的文件和非文件数据
包含了对POST、PUT、PATCH请求方式解析后的数据
利用了REST framework的parser解析器,不仅支持表单类型数据,也支持JSON数据等
2)query_params
query_params,查询参数,也叫查询字符串(query string )
request.query_params
与Django标准的request.GET
相同,只是更换了更正确的名称而已。
3)request.stream
获取django标准的request对象
2、基本使用
Django内置request
import json
from django.views import View
from django.http import HttpRequest
from django.http import HttpResponse
class DjangoView(View):
def get(self, request):
# 解析json数据
json_dict = json.loads(request.body.decode())
print(request)
#<WSGIRequest: GET '/djangoview/'>
print(json_dict)
#{'request': 'django-request', 'response': 'django-response'}
return HttpResponse('ok')
说明:
默认情况下, 编写视图类时,如果继承的是django内置的django.view.View视图基类,则视图方法中得到的request对象,是django默认提供的django.core.handlers.wsgi.WSGIRequest这个请求处理对象,无法直接提供的关于json数据数据处理。在编写api接口时很不方便,所以drf为了简写这块内容,在原来的HttpRequest的基础上面,新增了一个Request对象这个Request对象是单独声明的和原来django的HttpRequest不是父子关系。
同时注意:要使用drf提供的Request请求处理对象,必须在编写视图类时继承drf提供的视图基类
from rest_framework.views import APIView如果使用drf提供的视图基类APIView编写类视图,则必须使用来自drf提供的Request请求对象和Response响应对象
Drf request
from rest_framework.request import Request
from rest_framework.response import Response
from rest_framework.views import APIView
class DrfView(APIView):
def get(self, request):
print(request)
# <rest_framework.request.Request: GET '/drfview/'>
data = request.data # 根据Content-Type的值,自动解析类型
print(data)
# {'request': 'django-request', 'response': 'django-response'}
query_params = request.query_params.get('type')
print(query_params)
# drfview
print(request.stream)
# <WSGIRequest: GET '/drfview/'>
return Response('ok') # 根据Accepts的值,自动渲染类型
二、请求Response
rest_framework.response.Response
使用rest_framework.response.Response该类构造响应对象时,响应的具体数据内容会被转换(renderer渲染器)成符合前端需求的类型。
REST framework提供了
Renderer
渲染器,用来根据请求头中的Accept
(接收数据类型声明)来自动转换响应数据到对应格式。如果前端请求中未进行声明Accept,则会采用Content-Type方式处理响应数据,我们可以通过配置来修改默认响应格式。
REST_FRAMEWORK = {
'DEFAULT_RENDERER_CLASSES': ( # 默认响应渲染类
'rest_framework.renderers.JSONRenderer', # json渲染器,返回json数据
'rest_framework.renderers.BrowsableAPIRenderer', # 浏览器API渲染器,返回调试界面
)
}
1、构造方式
Response(data, status=None, template_name=None, headers=None, content_type=None)
1)drf的响应处理类和请求处理类不一样,Response就是django的HttpResponse响应处理类的子类。
2)data数据不要是render处理之后的数据,只需传递python的内建类型数据即可,REST framework会使用
renderer
渲染器处理data
。3)data不能是复杂结构的数据,如Django的模型类对象,对于这样的数据我们可以使用
Serializer
序列化器序列化处理后(转为了Python字典类型)再传递给data
参数。参数说明:
data
: 为响应准备的序列化处理后的数据;
status
: 状态码,默认200;
template_name
: 模板名称,如果使用HTMLRenderer
时需指明;
headers
: 用于存放响应头信息的字典;
content_type
: 响应数据的Content-Type,通常此参数无需传递,REST framework会根据前端所需类型数据来设置该参数。
2、常用属性
1).data
传给response对象的序列化后,但尚未render处理的数据
2).status_code
状态码的数字
3).content
经过render处理后的响应数据
3、状态码
1)信息告知 - 1xx
HTTP_100_CONTINUE HTTP_101_SWITCHING_PROTOCOLS
2)成功 - 2xx
HTTP_200_OK HTTP_201_CREATED HTTP_202_ACCEPTED HTTP_203_NON_AUTHORITATIVE_INFORMATION HTTP_204_NO_CONTENT HTTP_205_RESET_CONTENT HTTP_206_PARTIAL_CONTENT HTTP_207_MULTI_STATUS
3)重定向 - 3xx
HTTP_300_MULTIPLE_CHOICES HTTP_301_MOVED_PERMANENTLY HTTP_302_FOUND HTTP_303_SEE_OTHER HTTP_304_NOT_MODIFIED HTTP_305_USE_PROXY HTTP_306_RESERVED HTTP_307_TEMPORARY_REDIRECT
4)客户端错误 - 4xx
HTTP_400_BAD_REQUEST HTTP_401_UNAUTHORIZED HTTP_402_PAYMENT_REQUIRED HTTP_403_FORBIDDEN HTTP_404_NOT_FOUND HTTP_405_METHOD_NOT_ALLOWED HTTP_406_NOT_ACCEPTABLE HTTP_407_PROXY_AUTHENTICATION_REQUIRED HTTP_408_REQUEST_TIMEOUT HTTP_409_CONFLICT HTTP_410_GONE HTTP_411_LENGTH_REQUIRED HTTP_412_PRECONDITION_FAILED HTTP_413_REQUEST_ENTITY_TOO_LARGE HTTP_414_REQUEST_URI_TOO_LONG HTTP_415_UNSUPPORTED_MEDIA_TYPE HTTP_416_REQUESTED_RANGE_NOT_SATISFIABLE HTTP_417_EXPECTATION_FAILED HTTP_422_UNPROCESSABLE_ENTITY HTTP_423_LOCKED HTTP_424_FAILED_DEPENDENCY HTTP_428_PRECONDITION_REQUIRED HTTP_429_TOO_MANY_REQUESTS HTTP_431_REQUEST_HEADER_FIELDS_TOO_LARGE HTTP_451_UNAVAILABLE_FOR_LEGAL_REASONS
5)服务器错误 - 5xx
HTTP_500_INTERNAL_SERVER_ERROR
HTTP_501_NOT_IMPLEMENTED
HTTP_502_BAD_GATEWAY
HTTP_503_SERVICE_UNAVAILABLE
HTTP_504_GATEWAY_TIMEOUT
HTTP_505_HTTP_VERSION_NOT_SUPPORTED
HTTP_507_INSUFFICIENT_STORAGE
HTTP_511_NETWORK_AUTHENTICATION_REQUIRED