Django REST framwork 提供的视图的主要作用:
- 控制序列化器的执行(检验、保存、转换数据)
- 控制数据库查询的执行
1. DRF框架中的Request和Response
REST framework 传入视图的request对象不再是Django默认的HttpRequest对象,而是REST framework提供的扩展了HttpRequest类的Request类的对象。
Request对象的数据是自动根据前端发送数据的格式进行解析之后的结果。
1.1 Resquest常用属性
1.1.1 data属性
我们可以通过data属性获取到前端传递过来的请求体的数据。
1.1.2 query_params属性
我们可以通过query_params属性获取到前端传递过来的查询字符串数据。
1.2 Response
1.2.1 Response对象
在DRF框架的视图中,我们通过Response对象来返回JSON数据。
Response(data, status=None, template_name=None, headers=None, content_type=None)
参数
data
序列化器序列化后的数据
status
状态码,默认200
template_name
模板名称(几乎不用)
headers
用于存放响应头信息的字典
content_type
响应数据的Content-Type
案例代码:
class BookInfoAPIView(APIView): '''定义APIView DRF的视图核心任务就是操作数据库和序列化器 ''' def get(self, request): # 对数据库进行操作 books = BookInfo.objects.all() # 对序列化器进行操作 s = BookInfoModelSerializer(instance=books, many=True) # 响应JSON return Response(s.data)
这里因为,我们是查询数据,根据RESTful设计风格需要返回状态码为200,但是status默认值就是200,所以不用传递参数。
1.2.2 Response常用属性
1.2.2.1 data属性
通过data属性,我们可以获取到传递给Response的字典数据。
1.2.2.2 status_code属性
通过status_code属性,我们可以获取到传递给Response的status参数的值。
1.2.2.3 content属性
通过content属性,我们可以获取到经过Response处理过的JSON数据。
2. 视图
在DRF框架中,视图分为两大类,一个是通用视图,一个是视图集。
2.1 通用视图
在通用视图中,又分为两个视图基类、五个试图扩展类、视图子类。
2.1.1 视图基类
2.1.1.1 APIView
是REST framework提供的所有视图的基类,继承自Django的View
父类。
APIView
与View
的不同之处在于:
- 传入到视图方法中的是REST framework的
Request
对象,而不是Django的HttpRequeset
对象; - 视图方法可以返回REST framework的
Response
对象,视图会为响应数据设置(render)符合前端要求的格式; - 任何
APIException
异常都会被捕获到,并且处理成合适的响应信息; - 在进行dispatch()分发前,会对请求进行身份认证、权限检查、流量控制。
支持定义的属性:
- authentication_classes 列表或元祖,身份认证类
- permissoin_classes 列表或元祖,权限检查类
- throttle_classes 列表或元祖,流量控制类
在APIView
中仍以常规的类视图定义方法来实现get() 、post() 或者其他请求方式的方法。
案例代码:
from rest_framework.views import APIView from rest_framework.response import Response class BookInfoAPIView(APIView): '''定义APIView DRF的视图核心任务就是操作数据库和序列化器 ''' def get(self, request): # 对数据库进行操作 books = BookInfo.objects.all() # 对序列化器进行操作 s = BookInfoModelSerializer(instance=books, many=True) # 响应JSON return Response(s.data)
2.1.1.2 GenericAPIView
继承自APIVIew
,主要增加了操作序列化器和数据库查询的方法,作用是为下面Mixin扩展类的执行提供方法支持。通常在使用时,可搭配一个或多个Mixin扩展类。
提供的关于序列化器使用的属性与方法
-
属性:
- serializer_class 指明视图使用的序列化器
-
方法:
-
get_serializer_class(self)
返回序列化器类,默认返回
serializer_class
,可以重写,例如:def get_serializer_class(self): if self.request.user.is_staff: return FullAccountSerializer return BasicAccountSerializer
-
get_serializer(self, args, *kwargs)
返回序列化器对象,主要用来提供给Mixin扩展类使用,如果我们在视图中想要获取序列化器对象,也可以直接调用此方法。
注意,该方法在提供序列化器对象的时候,会向序列化器对象的context属性补充三个数据:request、format、view,这三个数据对象可以在定义序列化器时使用。
-
request 当前视图的请求对象
-
view 当前请求的类视图对象
-
format 当前请求期望返回的数据格式
-
-
提供的关于数据库查询的属性与方法
-
属性:
- queryset 指明使用的数据查询集
-
方法:
-
get_queryset(self)
返回视图使用的查询集,主要用来提供给Mixin扩展类使用,是列表视图与详情视图获取数据的基础,默认返回
queryset
属性,可以重写,例如:def get_queryset(self): user = self.request.user return user.accounts.all()
-
get_object(self)
返回详情视图所需的模型类数据对象,主要用来提供给Mixin扩展类使用。
在试图中可以调用该方法获取详情信息的模型类对象。
若详情访问的模型类对象不存在,会返回404。
该方法会默认使用APIView提供的check_object_permissions方法检查当前对象是否有权限被访问。
-
案例代码:
class BookInfoAPIView(GenericAPIView): '''使用GenericAPIView定义API''' # 1. 设置查询集 queryset = BookInfo.objects.all() # 2. 设置序列化器 serializer_class = BookInfoModelSerializer def get(self, request): # 3. 获取模型对象 qs = self.get_queryset() # 4. 获取序列化器对象 s = self.get_serializer(qs, many=True) return Response(s.data)
经过以上的讲解,我们对DRF框架中的两个视图基类已经有了初步的了解了。