django rest framework之请求与响应(详解)

前言：在上一篇文章，已经实现了访问指定URL就返回了指定的数据，这也体现了RESTful API的一个理念，每一个URL代表着一个资源。当然我们还知道RESTful API的另一个特性就是，发送不同的请求动作，会返还不同的响应，这篇文章就讲一下django-rest-framework这个工具在这方面给我们带来的便捷操作。

一、Request对象

平时我们在写Django的视图函数的时候，都会带上一个request参数，这样就能处理平时搭建网站时，浏览器访问网页时发出的常规的HttpRequest。但是现在我们导入了django-rest-framework，它能够对request进行拓展，并且提供更灵活的请求解析。这个特性体现在哪呢？请看下面这个例子：

<SPAN style="FONT-SIZE: 13px">request.POST # Only handles <SPAN style="COLOR: #ff0000">form data</SPAN>. Only works for '<SPAN style="COLOR: #ff0000">POST</SPAN>' method.
request.data # Handles <SPAN style="COLOR: #ff0000">arbitrary(任意的) data</SPAN>. Works for '<SPAN style="COLOR: #ff0000">POST', 'PUT' and 'PATCH</SPAN>' methods.
</SPAN>

request.POST只能处理前端发起的POST请求，只能处理表单提交的数据。而request.data可以处理任意数据，而不单单是前端提交的表单数据，可用于post, put, patch请求。

二、Response对象

和request对象一样，django-rest-framework也对其进行了很实用的拓展，在我上一篇文章的snippets/views.py中，我们导入了JsonResponse用于返回json格式的响应，在视图函数中是这样的：

@csrf_exempt
def snippet_list(request):
"""
because we want to be able to POST to this view from clients
that won't have a CSRF token we need to mark the view as csrf_exempt
List all code snippets, or create a new snippet.
"""
if request.method == "GET":
 snippets = Snippet.objects.all()
 serializer = SnippetSerializer(snippets, many=True)
 return JsonResponse(serializer.data, safe=False)

elif request.method == "POST":
 data = JSONParser().parse(request)
 serializer = SnippetSerializer(data=data)
 if serializer.is_valid():
  serializer.save()
  return JsonResponse(serializer.data, status=201)
 return JsonResponse(serializer.errors, status=400)

也就是说，在return的时候就需要指明json格式，这样显得很不实用而且很单一，所以经过拓展后的Reponse对象就很方便了，它会根据客户端的请求头部信息来确定正确的内容类型以返回给客户端。只需如下代码：

<SPAN style="FONT-SIZE: 13px">return Response(data) # <SPAN style="COLOR: #ff0000">Renders to content type as requested by the client.
</SPAN></SPAN>

三、状态码

我们知道发送http请求时会返回各种各样的状态吗，但是都是简单的数字，比如200、404等，这些纯数字标识符有时候可能不够明确或者客户端在使用的时候不清楚错误信息甚至是没注意看不到，所以django-rest-framework也对此进行了优化，状态码会是HTTP_400_BAD_REQUEST、HTTP_404_NOT_FOUND这种，极大的提高可读性

四、包装API视图

REST框架提供了两个可用于编写API视图的包装器。

•@api_view装饰器用于处理基于函数的视图

•APIView类用在基于视图的类上

这些包装提供了一些功能，让我们省去很多工作。比如说确保你在视图中收到Request对象或在你的Response对象中添加上下文，这样就能实现内容通信。

另外装饰器可以在接收到输入错误的request.data时抛出ParseError异常，或者在适当的时候返回405 Method Not Allowed状态码。

五、Pulling it all together(使用)

Okay, let's go ahead and start using these new components to write a few views.

We don't need our JSONResponse class in views.py any more, so go ahead and delete that. Once that's done we can start refactoring(重构) our views slightly.

在views.py文件中我们不再需要我们的JSONResponse类，所以继续删除。一旦完成，我们可以开始细微地重构我们的视图。

from rest_framework import status
from rest_framework.decorators import api_view
from rest_framework.response import Response
from snippets.models import Snippet
from snippets.serializers import SnippetSerializer

@api_view(['GET', 'POST'])
def snippet_list(request):
"""
List all code snippets, or create a new snippet.
"""
if request.method == 'GET':
 snippets = Snippet.objects.all()
 serializer = SnippetSerializer(snippets, many=True)
 return Response(serializer.data)

elif request.method == 'POST':
 serializer = SnippetSerializer(data=request.data)
 if serializer.is_valid():
  serializer.save()
  return Response(serializer.data, status=status.HTTP_201_CREATED)
 return Response(serializer.errors, status=status.HTTP_400_BAD_REQUEST)

可以看出，经过改进的代码已经把上面所说的几个django-rest-framework带来的特性都应用起来了，我们可以看出程序代码量变少，并且能处理的情况更多了。 比如说，在原本的视图函数snippet_detail中，处理'PUT'请求的时候，需要先解析前端发来的json格式的数据再进一步处理：

<SPAN style="FONT-SIZE: 13px">data = JSONParser().parse(request)
serializer = SnippetSerializer(snippet, data=data)
</SPAN>

也就是说需要分成两步实现，而且这里有一个限制就是只能解析json格式的数据流。而改进后的程序只需一行代码：

<SPAN style="FONT-SIZE: 13px">serializer = SnippetSerializer(data=request.data)
</SPAN>

request.data can handle incoming json requests, but it can also handle other formats. Similarly we're returning response objects with data, but allowing REST framework to render the response into the correct content type for us.

request.data就可以获取到提交过来的数据了，并且可以处理各种数据和各种请求动作，方便了开发。还有在return的时候也不需要指定json格式了，由原本的：

<SPAN style="FONT-SIZE: 13px">return JsonResponse(serializer.data, status=201)
</SPAN>

改成了

<SPAN style="FONT-SIZE: 13px">return Response(serializer.data,status=status.HTTP_201_CREATED)
</SPAN>

这也意味着返回给客户端的可以是json或者html等格式的内容，返回HTML格式的内容的话，会在浏览器返回经过渲染的、更美观的页面。同时可以看出状态码也改进成了django-rest-framework给我们带来的可读性更高的状态标识码，以上这些措施都很大程度的提高了对客户的友好度。

对于另一个视图函数的修改也是同样的原理，这里就不做同样的讲解了，代码如下：

@api_view(['GET', 'PUT', 'DELETE'])
def snippet_detail(request, pk):
"""
Retrieve, update or delete a code snippet.
"""
try:
 snippet = Snippet.objects.get(pk=pk)
except Snippet.DoesNotExist:
 return Response(status=status.HTTP_404_NOT_FOUND)

if request.method == 'GET':
 serializer = SnippetSerializer(snippet)
 return Response(serializer.data)

elif request.method == 'PUT':
 serializer = SnippetSerializer(snippet, data=request.data)
 if serializer.is_valid():
  serializer.save()
  return Response(serializer.data)
 return Response(serializer.errors, status=status.HTTP_400_BAD_REQUEST)

elif request.method == 'DELETE':
 snippet.delete()
 return Response(status=status.HTTP_204_NO_CONTENT)

来源：http://www.cnblogs.com/0zcl/p/7787354.html