DRF-基类: APIview和GenericAPIView

1. APIview

• APIView是REST framework提供的所有视图的基类, 继承自Django的View父类

• APIView与View的不同之处:

• 传入到视图方法中的是REST framework的Request对象, 而不是Django的HttpRequeset对象；
• 视图方法可以返回REST framework的Response对象, 视图会为响应数据设置（render）符合前端要求的格式；
• 任何APIException异常都会被捕获到, 并且处理成合适的响应信息；
• 在进行dispatch()分发前, 会对请求进行身份认证 权限检查 流量控制。

• APIView支持定义的属性:

• authentication_classes 列表或元祖, 身份认证类
• permissoin_classes 列表或元祖, 权限检查类
• throttle_classes 列表或元祖, 流量控制类

• 注意! 在APIview中仍然需要常规的定义get(), post() 或者其他请求方式的方法

from rest_framework.views import APIView
from rest_framework.response import Response
# 继承自APIView
class StudentAPIView(APIView):
		def get(self, request)
			sutdents = StudentInfo.objects.all()
			serializer = StudentInfoSerializer(many=True, students)
			return Response(serializer.data)

2. GenericAPIView

• rest_framework.generics.GenericAPIView
• 继承自APIVIew, 增加了对于列表视图和详情视图可能用到的通用支持方法. 通常使用时, 可搭配一个或多个Mixin扩展类

支持定义的属性:

• (list / retrieve)列表视图与详情视图通用:
• queryset: 列表视图的查询集
• serializer_class: 视图使用的序列化器
• (list)列表视图专用:
• pagination_class: 分页控制类
• filter_backends: 过滤控制后端
• (retrieve)详情页视图使用:
• lookup_field 查询单一数据库对象时使用的条件字段，默认为’pk’, 可以指定为’id’
• filter_backends: lookup_url_kwarg 查询单一数据时URL中的参数关键字名称，默认与look_field相同

(list / retrieve)通用支持的方法

• get_queryset(self):
• 返回视图使用的查询集, 是列表视图与详情视图获取数据的基础, 默认返回queryset属性, 可以重写, 控制其返回的查询集

class StudentAPIView(APIView):
	def get_queryset(self):
		keyword = self.request.query_params.get("keyword")# 尝试从request的查询字符串中获得keyword(用户想搜索的用户)
		if keyword:# 判断过滤的keyword存不存在(端传没传), 如果前端传了就返回给前端相关的用户
			return self.queryset.filter(username__contains=keyword)
		return self.queryset.all().order_by('id')

• get_serializer_class(self)
• 返回序列化器类，默认返回serializer_class，可以重写，例如：

class StudentAPIView(APIView):
	def get_serializer_class(self):
		ifself.request.user.is_staff: # 判断用户是否是超级管理员
			return FullAccountSerializer # 就使用详细的序列化器
		return BasicAccountSerializer

• get_serializer(self, args, *kwargs)
• 返回序列化器对象, 被其他视图或扩展类使用, 如果我们在视图中想要获取序列化器对象, 可以直接调用此方法。
• 注意!在提供序列化器对象的时候, REST framework会向对象的context属性补充三个数据：request、format、view，这三个数据对象可以在定义序列化器时使用。

(retrieve)详情页支持的方法

• get_object(self)

• 返回详情视图所需的模型类数据对象，默认使用lookup_field参数来过滤queryset。 在试图中可以调用该方法获取详情信息的模型类对象
• 若详情访问的模型类对象不存在，会返回404
• 该方法会默认使用APIView提供的check_object_permissions方法检查当前对象是否有权限被访问

url(r'^books/(?P\d+)/$', views.BookDetailView.as_view()),
class StudentAPIView(GenericAPIView):
	queryset = StudentInfo.objects.all() # 指定要操作的数据库
	serializer_class = StudentInfoSerializer # 指定序列化器
	def get(self, request, pk): # 重写get方法
		student = self.get_object() # 得到前端跟随路径传进来的pk值 从数据库进行查找并得到一个对象
		serializer = self.get_serializer(student) # 进行序列化操作得到一个序列化器对象
		return Response(serializer.data)