Request和Response

一、request

REST framework的 Request 扩展了标准的 HttpRequest,添加支持了REST framework灵活的request解析和request认证


1.Request parsing


REST framework的Request对象提供了灵活的request解析,允许你用JSON数据或者其他的媒体类型处理request,和通常处理表单数据一样 。

.date

request.data 返回request body的解析后的内容,这和标准的request.POST和request.FILES属性相似,除了以下这些:

  • 它包含所有的解析的内容,包括file和non-file输入。
  • 他提供对HTTP方法的内容的解析不止于POST,这意味着你可以存取基于PUT和PATCH的内容的request。
  • 相对于只支持表单数据,他提供了对REST framework灵活的request解析,例如你可以用处理表单数据一样的方式处理JSON数据

.query_params

request.query_params是对于request.GET更准确的命名同义词,为清楚起见,在你的代码中,我们建议使用request.query_params来代替Django标准的request.GET。这样能够让你的代码库更正确和清晰,可能包括任何的HTTP方法类型查询参数,而不止于GET request.

.parsers

APIView类或@api_view装饰将确保这个属性将自动设置为Parser的实例列表,根据parser_classes设置视图或基于DEFAULT_PARSER_CLASSES设置。
通常你不需要访问该属性。

注意:
如果一个客户端发送畸形的内容,然后访问request.data,可能会导致一个ParseError,默认情况下 REST framework 的
APIView类或@api_view装饰将捕获错误并返回一个400错误请求响应。
如果一个客户端发送一个请求的内容类型不能解析,将抛出UnsupportedMediaType异常,默认情况下将被捕获并返回一个415 Unsupported Media Type 响应。


2.Content negotiation(内容协商)


request公开一些属性,允许您确定内容协商阶段的结果。这允许您实现为不同的媒体类型选择不同的连载方案等行为。

.accepted_renderer

The renderer instance what was selected by the content negotiation stage.(渲染器实例选择的内容协商阶段)

.accepted_media_type

一个字符串代表内容协商阶段接受的媒体类型。


3.Authentication


REST framework 提供了灵活并且针对每个request的身份认证系统,他允许你实现以下功能:

  • 为你的API不同的部分选用不同的身份认证策略
  • 提供了多个身份认证使用策略
  • 通过传入的request提供了用户的token信息的关联。

.user

request.user通常返回django.contrib.auth.models.User的实例,虽然这个行为取决于所使用的身份验证策略。
如果请求是未经身份验证的,request.user的默认值是django.contrib.auth.models.AnonymousUser的实例

For more details see the authentication documentation.

.auth

request.auth返回任何额外的身份认证环境(context),request.auth具体的行为取决于使用的身份认证策略,但是他通常是一个request身份认证的token实例
如果request未经身份验证,或者没有额外的环境,request.auth的默认值为None。

For more details see the authentication documentation.

.authenticators

APIView类或@api_view装饰将确保这个属性将自动设置为ofAuthentication实例列表,根据authentication_classes设置视图或基于DEFAULT_AUTHENTICATORS设置。

通常你不需要访问该属性。


4.浏览器增强


REST framework 支持一些浏览器增强,像基于浏览器的 PUT, PATCH 和 DELETE 形式。

.method

request.method返回request的HTTP方法的大写字符串表示。
基于浏览器的PUT,PATCH和DELETE形式是透明支持的。

For more information see the browser enhancements documentation.

.content_type

request.content_type 返回一个字符串对象代表HTTP的request body的媒体类型。
如果没有提供媒体类型则返回一个空字符串。
您通常不需要直接访问请求的内容类型,您将通常依赖于REST framework的默认请求解析行为。
如果你需要访问请求的内容类型你应该使用.content_type属性优先于使用request.META.get('HTTP_CONTENT_TYPE'),他提供基于浏览器的non-form内容的透明支持。

For more information see the browser enhancements documentation.

.stream

request.stream返回一个代表request body 内容的流。
你通常不需要直接的访问request的内容,你将通常依赖于REST framework的默认请求解析行为。
如果你需要直接访问原始内容,您应该使用.stream属性优先于使用request.content。他提供基于浏览器的non-form内容的透明支持。

For more information see the browser enhancements documentation.


5.标准HttpRequest属性


正如REST framework的Request扩展了Django的HttpRequest,所有其他标准的属性和方法也可可用的,例如:request.META和request.session字典可以正常使用。

注意,由于实现原因Request 类不从HttpRequest类继承,而是使用扩展类成分


二、response


REST framework 靠提供Response 类来支持HTTP内容协商,这个类允许你返回可以被渲染多种内容类型的的内容,具体类型取决于客户端的请求。

Response 类继承于Django的SimpleTemplateResponse,Response 对象被初始化为本地的Python原始数据组成的数据,REST framework使用标准的HTTP内容协商来决定怎样渲染最后的response数据。
这里没有要求你去使用Response 类,你可以根据需要在视图中返回正规的HttpResponse 或者StreamingHttpResponse 对象。使用Response 类简单的提供了一个漂亮的接口来返回协商的内容Web接口的响应,这可以被渲染成多种形式。
除非你因为一些原因还要大量定制REST framework,你应该一直在视图中使用APIView 类或者@api_view函数返回Response 对象。这些允许视图可以执行内容协商并为response选择适当的渲染器。

1.Response()


Response(data, status=None, template_name=None, headers=None, content_type=None)

不像正规的HttpResponse对象,你不用渲染的内容代替没有渲染的数据实例化Response对象,这可能由一些Python的原始数据组成。(Unlike regular HttpResponse objects, you do not instantiate Response objects with rendered content. Instead you pass in unrendered data, which may consist of any Python primitives.)

Response类使用的渲染器不能在本地处理复杂的数据类型,就像Django的模型实例,所以你需要在创建Response对象之前,先把数据序列化成原始的数据类型。
你可以使用REST framework的Serializer 类来执行这些数据序列化,或者使用你自己自定义的序列化器。

参数:

  • data:为response序列化的数据
  • status:为响应状态代码。默认为200。 See also status codes。
  • template_name:如果选用HTMLRenderer ,为使用的模板名称。
  • headers:response中使用的HTTP头的字典。
  • content_type:response中内容的类型。通常这回被内容协商的渲染器设置成自动,但是这可能有一些原因你需要显式地指定内容类型。

2.属性


.data

Request 对象没有渲染的内容

.status_code

HTTP response的状态码

.content

response的渲染的内容,在访问.content之前必须先调用.render()方法。

.template_name

如果提供template_name,只需要HTMLRenderer 或者其他自定义模板渲染器是response接受的渲染器。

.accepted_renderer

用来渲染response的渲染器实例
在视图中返回response之前被APIView 或者@api_view立即设置为自动。

3.标准的HttpResponse属性


Response类扩展了SimpleTemplateResponse,所有常用的属性和方法在response中都是可用的。例如你可以在response中用标准的方式设置headers。

response = Response()
response['Cache-Control'] = 'no-cache'

.render()

** 参数:** .render()

与任何其他TemplateResponse一样,这个方法被用来渲染response的序列化的数据到最后的response内容。当.render()被调用时,response的内容会被设置成在accepted_renderer实例上调用.render(data, accepted_media_type, renderer_context) 方法的结果。
你通常不需要自己调用.render(),他被django的标准的response周期控制。

你可能感兴趣的:(Request和Response)