教程2:请求和响应
从现在开始,我们将真正开始讨论REST框架的核心。让我们介绍几个基本的构建块。
请求对象(Request objects)
REST框架引入了一个Request对象,该对象扩展了HttpRequest,并提供更灵活的请求解析。的核心功能。Request对象是request.data属性,类似于request.POST,但是对于使用WebAPI更有用。
request.POST # 只能处理表单数据,只能再POST请求下工作
request.data # 处理任意数据,'POST', 'PUT' 和'PATCH' 请求都能使用
响应对象(Response objects)
REST框架还引入了一个Response对象,它是TemplateResponse这将获取未呈现的内容,并使用内容协商来确定返回给客户端的正确内容类型。
return Response(data) # 呈现(Renders) 客户端请求的数据类型
状态码
在视图中使用数字HTTP状态代码并不总是可以进行明显的读取,而且如果错误代码出错,很容易不注意到这一点。REST框架为每个状态代码提供了更显式的标识符,如HTTP_400_BAD_REQUEST在status模块。最好始终使用这些,而不是使用数字标识符。
包装API视图
REST框架提供了两个包装器,可以用来编写API视图。
这个@api_view用于处理基于功能的视图的装饰器。
这个APIView类,用于处理基于类的视图。
这些包装器提供了一些功能,例如确保您收到Request实例,并将上下文添加到Response对象,以便可以执行内容协商。
包装器还提供了诸如返回之类的行为。405 Method Not Allowed在适当的情况下作出反应,并处理任何ParseError访问时发生的异常。request.data输入错误。
把所有都组合在一起
好的,让我们继续使用这些新组件来编写一些视图。
我们不再需要JSONResponse用于views.py,那就把它删掉吧。完成之后,我们就可以开始稍微重构我们的视图了。
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