Reques
-
REST framework
传入视图中的Request
对象不再是原生Django
的HttpRequest
对象,而是框架提供了HttpRequest
扩展类的Request
对象
-
REST framework
提供了Parser
解析器, 在接收到请求后会自动根据Content-Type
指明的请求数据类型(如JSON
、表单等)将请求数据进行parse
解析, 解析为类字典对象保存到Request
对象中
-
Request
对象的数据是自动根据前端发送数据的格式进行解析之后的结果
- 无论前端发送的哪种格式的数据, 我们都可以以统一的方式读取数据
常用属性:
data
request.data
返回解析之后的请求体数据. 类似于Django
中标准的request.POST
和 request.FILES
属性, 包含一些特性:
- 包含了解析之后的文件和非文件数据
- 包含了对
POST
, PUT
, PATCH
请求方式解析后的数据
- 利用了
REST framework
的parsers
解析器,不仅支持表单类型数据,也支持JSON
数据
query_params
-
request.query_params
与Django
标准的request.GET
相同, 只是更换了更正确的名称
-request.query_params.get(Key)
得到查询字符串中指定的Key
Response
REST framework
提供了一个响应类Response
, 使用该类构造响应对象时, 响应的具体数据内容会被转换(rende
r渲染)成符合前端需求的类型
构造方法:
Response(data, status=None, template_name=None, headers=None, content_type=None)
-
data
数据不要是render
处理之后的数据, 只需传递python
的内建类型数据即可,REST framework
会使用renderer
渲染器处理data
-
data
不能是复杂结构的数据, 如Django
的模型类对象, 对于这样的数据我们可以使用Serializer
序列化器序列化处理后(转为了Python
字典类型)再传递给data
参数
参数说明:
-
data
: 为响应准备的序列化处理后的数据;
-
status
: 状态码,默认200;
-
template_name
: 模板名称,如果使用HTMLRenderer
时需指明;
-
headers
: 用于存放响应头信息的字典;
-
content_type
: 响应数据的Content-Type
,通常此参数无需传递,REST framework
会根据前端所需类型数据来设置该参数。
状态码
REST framewrok
在rest_framework.status
模块中提供了常用状态码常量
信息告知 - 1xx
HTTP_100_CONTINUE
HTTP_101_SWITCHING_PROTOCOLS
成功 - 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
重定向 - 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
客户端错误 - 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
服务器错误 - 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
网友评论