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周期控制。
