DRF API指南之 Views
参考文档：https://q1mi.github.io/Django-REST-framework-documentation/api-guide/serializers_zh/
Django中基于类的视图对于旧式风格的视图来说是良好的替代品。
REST framework提供了一个APIView类，它是Django的View类的子类。
APIView类和一般的View类有以下不同：
- 被传入到处理方法的请求不会是Django的
HttpRequest类的实例，而是REST framework的Request类的实例。 - 处理方法可以返回REST framework的
Response，而不是Django的HttpRequest。视图会管理内容协议，给响应设置正确的渲染器。 - 任何
APIException异常都会被捕获，并且传递给合适的响应。 - 进入的请求将会经过认证，合适的权限和（或）节流检查会在请求被派发到处理方法之前运行。
使用APIView类和使用一般的View类非常相似，通常，进入的请求会被分发到合适处理方法比如.get()，或者.post。另外，很多属性会被设定在控制API策略的各种切面的类上。
比如：
from rest_framework.views import APIView
from rest_framework.response import Response
from rest_framework import authentication, permissions
class ListUsers(APIView):
"""
列出系统中的所有用户的视图。
* 需要token认证
* 只有管理员用户可以访问这个视图。
"""
authentication_classes = (authentication.TokenAuthentication,)
permission_classes = (permissions.IsAdminUser,)
def get(self, request, format=None):
"""
Return a list of all users.
"""
usernames = [user.username for user in User.objects.all()]
return Response(usernames)
API策略属性
下面这些属性控制了API视图可拔插的那些方面。
.renderer_classes
.parser_classes
.authentication_classes
.throttle_classes
.permission_classes
.content_negotiation_class
API policy instantiation methods
下面这些方法被REST framework用来实例化各种可拔插的API策略。你通常不需要重写这些方法。
.get_renderers(self)
.get_parsers(self)
.get_authenticators(self)
.get_throttles(self)
.get_permissions(self)
.get_content_negotiator(self)
.get_exception_handler(self)
API policy implementation methods
下面这些方法会在请求被分发到具体的处理方法之前调用。
.check_permissions(self, request)
.check_throttles(self, request)
.perform_content_negotiation(self, request, force=False)
Dispatch methods
下面这些方法会被视图的.dispatch()方法直接调用。它们在调用.get, .post(), put(), patch()和delete()之类的请求处理方法之前或者之后执行任何需要执行的操作。
.initial(self, request, *args, **kwargs)
在处理方法调用之前进行任何需要的动作。 这个方法用于执行权限认证和限制，并且执行内容协商。 你通常不需要重写此方法。
.handle_exception(self, exc)
任何被处理请求的方法抛出的异常都会被传递给这个方法，这个方法既不返回Response的实例，也不重新抛出异常。
默认的实现会处理rest_framework.expceptions.APIException的任何子类异常，以及Django的Http404和PermissionDenied异常，并且返回一个适当的错误响应。
如果你需要在自己的API中自定义返回的错误响应，你需要重写这个方法。
.initialize_request(self, request, *args, **kwargs)
确保传递给请求处理方法的请求对象是Request的实例，而不是通常的DjangoHttpResquest的实例。
你通常不需要重写这个方法。
.finalize_response(self, request, response, *args, **kwargs)
确保任何从处理请求的方法返回的Response对象被渲染到由内容协商决定的正确内容类型。
你通常不需要重写这个方法。
基于函数的视图
说[基于类的视图]不管什么时候都是更好的解决方案，那是错误的。
在REST framework中，你也可以使用常规的基于函数的视图。它提供了一组简单的装饰器，用来包装你的视图函数，以确保视图函数会收到Request（而不是Django一般的HttpRequest)对象，并且返回Response（而不是Django的HttpResponse）对象，同时允许你设置这个请求的处理方式。
@api_view()
函数签名: @api_view(http_method_names=['GET'], exclude_from_schema=False)
此功能的核心是api_view装饰器，它接受视图应该响应的HTTP方法列表的参数。 比如，你可以像这样写一个返回一些数据的非常简单的视图。
from rest_framework.decorators import api_view
@api_view()
def hello_world(request):
return Response({"message": "Hello, world!"})
这个视图会使用settings中指定的默认的渲染器，解析器，认证类等等。
默认的情况下，只有GET请求会被接受。其他的请求方法会得到一个"405 Method Not Allowed"响应。可以像下面的示例代码一样改变默认行为：
@api_view(['GET', 'POST'])
def hello_world(request):
if request.method == 'POST':
return Response({"message": "Got some data!", "data": request.data})
return Response({"message": "Hello, world!"})
你也可以用exclude_from_schema参数标记API视图来忽略任何自动生成的视图,
@api_view(['GET'], exclude_from_schema=True)
def api_docs(request):
...
API 策略装饰器
REST framework提供了一组可以加到视图上的装饰器来重写默认设置。这些装饰器必须放在@api_view的后(下)面。比如，要创建一个使用限制器确保特定用户每天只能调用一次的视图，可以用@throttle_classes装饰器并给它传递一个限制器类的列表。
from rest_framework.decorators import api_view, throttle_classes
from rest_framework.throttling import UserRateThrottle
class OncePerDayUserThrottle(UserRateThrottle):
rate = '1/day'
@api_view(['GET'])
@throttle_classes([OncePerDayUserThrottle])
def view(request):
return Response({"message": "Hello for today! See you tomorrow!"})
这些装饰器和上文中的APIView的子类中设置的属性相对应。
可用的装饰器有：
@renderer_classes(...)@parser_classes(...)@authentication_classes(...)@throttle_classes(...)@permission_classes(...)
这些装饰器中的每一个都接受一个参数，这个参数必须是类的列表或元组。