一、 Serialization序列化
Restframwork序列化方式分为Serializer和ModelSerializer两种方式
Serializer提供了序列化和反序列化两种作用:
定义好一个Model类:
定义好一个序列化类:
序列化:
serializer = SnippetSerializer(snippet)
其中snippet是一个model类的实例
serializer.data
调用序列化类的data
静态方法就可以得到序列化后的对应数据。
序列化类也可以传入Model类的querysets
类型来序列化多组数据,只需要将其中的一个many参数改为True,即many=True
,
serializer = SnippetSerializer(querysets)
serializer.data
通过以上的操作得到的数据类型为python的基本数据类型,可以通过一下方式将数据转化成json
数据
from rest_framework.renderers import JSONRenderer
content = JSONRenderer().render(serializer.data)
反序列化:
首先我们需要将json数据转化成流
,然后在转化成python基本的数据结构
import io
stream = io.BytesIO(content)
通过io模块将json数据类型转化成流
data = JSONParser().parse(stream)
将流转化成python基本的数据结构
serializer = SnippetSerializer(data=data)
反序列化数据
serializer.is_valid()
校验数据
serializer.validated_data
查看校验通过的数据
serializer.save()
保存数据(调用序列化类的creat方法)ModelSerializer同Serializer很相似,只不过建立了序列化类和Model类的强联系,简化了代码,提高了代码的可重用性。
基本的用法和Serializer一样,这里就不一一演示了。我们通过序列化类的使用,就可以快速实现API数据接口了。从而简化了开发的过程实现,让我们有更多的时间关注业务逻辑。
简单的视图处理类实现数据的查询和增加:
二、视图类的使用
Restful规范约定了API书写的基本规范,基于类的视图处理简单易懂,允许重用常用的重复功能,是一个非常好的模式。
APIView:
下面看一下给予APIView实现的视图类:
在之前,通过Django来搭建项目,当我们通过类的方式写视图处理事,都是让视图类继承view.View
,继承View类,实现了视图类最基本的执行流程,View类提供了一个dispatch方法,通过反射来执行处理对应请求的视图类方法,但现在这么一点点的功能,对于我们的开发没有多大的帮助,所以restframework提供了一个APIView
类,它继承了View类,同时在View类的基础上,重新封装了request,增添了各种认证功能等,强化了视图类的功能。GenericAPIView + Mixins
.
使用基于类的视图的一大优势在于它允许我们轻松地编写可重用的代码。到目前为止,我们一直使用的增删改查等操作,对于我们创建的任何模型支持的API视图都非常相似的。这些常见行为在REST框架的Mixin是类中实现起来就非常简单。
Mixins
类中重写了增删改查查五个最常见的视图类的处理方法,根据我们的需要,我们可以选择性的继承其中的处理方法,从而只关系我们需要什么,就继承什么了。
mixins.CreateModelMixin
mixins.mixins.ListModelMixin
mixins.RetrieveModelMixin
mixins.UpdateModelMixin
mixins.DestroyModelMixin
由于mixins类只关注与视图类的处理方法,而没有实现视图类基本执行流程所需的其他功能性模块,所以在继承mixins下的视图处理类时,还需要借助于APIView
的功能实现。
但是由于mixins类的作用是将重复性的代码段封装到了统一的一个处理类下,我们还需要一个方法可以将视图处理所需要的数据传递给对应的mixins类下的视图处理方法,很显然APIView并没有给我们提供这样的功能。restframework又给我们在APIView的基础上封装了一层,它就是GenericAPIView
,它继承了APIView,同时有增加了get_queryset()
和get_serializer()
方法,从而可以实现我们的需求了。generics下的ListCreateAPIView和RetrieveUpdateDestroyAPIView类
使用mixin类,我们重写了视图,使用的代码比以前略少,但我们可以更进一步。REST框架提供了一组已经混合的通用视图。ListCreateAPIView
和RetrieveUpdateDestroyAPIView
ViewSetMixin+APIView
ViewSetMixin类重写了as_view方法,urls需要在.as_view()中传入请求方法对应的字典,ViewSetMixin类重写了as_view方法通过反射找到对应的请求处理函数,可以少写urls,或者用路由注册器来注册url。ModelViewSet
ModelViewSet集成了上面的所有的可用功能,最大限度的封装了能封装的代码,可以择时选择。