在RESTful API中,接口返回的是JsON,JsON的内容对应的是数据库中的数据,DRF是通过序列化(Serialization)的技术,把数据模型转换为JsON的,反之,叫做反序列化(deserialization)。本文就来揭开DRF序列化技术的神秘面纱。
创建虚拟环境虚拟环境是独立的Python环境,可以和系统环境分离,只安装需要的包即可,使用以下命令创建并激活:
# 创建Python虚拟环境python -m venv env# 激活虚拟环境env\Scripts\activate.bat # Mac中使用`source env/bin/activate`
退出虚拟环境用deactivate。
接着在虚拟环境中安装本文用到的包:
pip install djangopip install djangorestframeworkpip install pygments # 代码高亮
创建项目创建project:
django-admin startproject tutorial
创建app:
cd tutorialpython manage.py startapp snippets
在tutorial/settings.py
中的INSTALLED_APPS
添加snippets
和rest_framework
:
INSTALLED_APPS = [ ... 'rest_framework','snippets.apps.SnippetsConfig',]
创建model只有添加后,app才会生效哦。
编辑snippets/models.py
,创建Snippet模型:
from django.db @R_301_5565@ modelsfrom pygments.lexers @R_301_5565@ get_all_lexersfrom pygments.styles @R_301_5565@ get_all_stylesLEXERS = [item for item in get_all_lexers() if item[1]]LANGUAGE_CHOICES = sorted([(item[1][0],item[0]) for item in LEXERS])STYLE_CHOICES = sorted([(item,item) for item in get_all_styles()])class Snippet(models.Model): created = models.DateTimeFIEld(auto_Now_add=True) Title = models.CharFIEld(max_length=100,blank=True,default='') code = models.TextFIEld() linenos = models.BooleanFIEld(default=False) language = models.CharFIEld(choices=LANGUAGE_CHOICES,default='python',max_length=100) style = models.CharFIEld(choices=STYLE_CHOICES,default='frIEndly',max_length=100) class Meta: ordering = ['created']
Snippet有6个字段,created、Title、code、linenos、language、style。
接着同步数据库:
python manage.py makemigrations snippetspython manage.py migrate
创建Serializerrest_framework.serializers的结构如下:
查看python模块中的成员,需要勾选:
之前我们用过HyperlinkedModelSerializer,是封装后的符合RESTful良好设计的序列化器,这里直接使用更底层的Serializer。在snippets
目录下创建serializers.py
,添加以下代码:
from rest_framework @R_301_5565@ serializersfrom snippets.models @R_301_5565@ Snippet,LANGUAGE_CHOICES,STYLE_CHOICESclass SnippetSerializer(serializers.Serializer): ID = serializers.IntegerFIEld(read_only=True) Title = serializers.CharFIEld(required=False,allow_blank=True,max_length=100) code = serializers.CharFIEld(style={'base_template': 'textarea.HTML'}) linenos = serializers.BooleanFIEld(required=False) language = serializers.ChoiceFIEld(choices=LANGUAGE_CHOICES,default='python') style = serializers.ChoiceFIEld(choices=STYLE_CHOICES,default='frIEndly') def create(self,valIDated_data): """ Create and return a new `Snippet` instance,given the valIDated data. """ return Snippet.objects.create(**valIDated_data) def update(self,instance,valIDated_data): """ Update and return an existing `Snippet` instance,given the valIDated data. """ instance.Title = valIDated_data.get('Title',instance.Title) instance.code = valIDated_data.get('code',instance.code) instance.linenos = valIDated_data.get('linenos',instance.linenos) instance.language = valIDated_data.get('language',instance.language) instance.style = valIDated_data.get('style',instance.style) instance.save() return instance
代码第一部分定义了序列化/反序列化的字段,字段定义方式类似于Form。第二部分的create()
和update()
方法定义了调用serializer.save()
时,创建和更新实例的处理方式。
既然已经创建好了Serializer,何不玩玩它?只有玩了才知道序列化的技术细节。这里用到了Django shell,可以在命令行实时看到输出结果:
python manage.py shell
首先通过模型新增2条测试数据:
from snippets.models @R_301_5565@ Snippetfrom snippets.serializers @R_301_5565@ SnippetSerializerfrom rest_framework.renderers @R_301_5565@ JsONRendererfrom rest_framework.parsers @R_301_5565@ JsONParsersnippet = Snippet(code='foo = "bar"\n')snippet.save()snippet = Snippet(code='print("hello,world")\n')snippet.save()
接着把它序列化看看:
serializer = SnippetSerializer(snippet)serializer.data# {'ID': 2,'Title': '','code': 'print("hello,world")\n','linenos': False,'language': 'python','style': 'frIEndly'}
因为
snippet
变量最后引用的是第2个数据模型的实例,所以这里只显示第2条数据。
serializer.data返回的是个字典,最后把字典转换为JsON:
content = JsONRenderer().render(serializer.data)content# b'{"ID": 2,"Title": "","code": "print(\"hello,world\")\n","linenos": false,"language": "python","style": "frIEndly"}'
这就是序列化的过程,模型实例→Python字典→JsON。
反序列化的过程是类似的,先把JsON转换为Python字典:
@R_301_5565@ iostream = io.BytesIO(content)data = JsONParser().parse(stream)
再把字典转换为模型实例:
serializer = SnippetSerializer(data=data)serializer.is_valID()# Trueserializer.valIDated_data# OrderedDict([('Title',''),('code','print("hello,world")\n'),('linenos',False),('language','python'),('style','frIEndly')])serializer.save()# <Snippet: Snippet object>
因为SnippetSerializer的create()方法代码是
return Snippet.objects.create(**valIDated_data)
,所以serializer.save()
会在数据库中新增1条数据,并返回Snippet模型实例。
另外,序列化对象不只有模型实例,也可以是数据集:
serializer = SnippetSerializer(Snippet.objects.all(),many=True)serializer.data# [OrderedDict([('ID',1),('Title','foo = "bar"\n'),'frIEndly')]),OrderedDict([('ID',2),3),world")'),'frIEndly')])]
使用ModelSerializersrest_framework.serializers.Serializers比较底层,需要重复定义model中的字段,DRF的作者当然也想到了这个问题,并且给出了解决办法:把Serializers封装成ModelSerializers。在snippets/serializers.py
中替换SnippetSerializer
为:
class SnippetSerializer(serializers.ModelSerializer): class Meta: model = Snippet fIElds = ['ID','Title','code','linenos','language','style']
写法果然简洁了很多。使用Django shell打印出来看看:
from snippets.serializers @R_301_5565@ SnippetSerializerserializer = SnippetSerializer()print(repr(serializer))# SnippetSerializer():# ID = IntegerFIEld(label='ID',read_only=True)# Title = CharFIEld(allow_blank=True,max_length=100,required=False)# code = CharFIEld(style={'base_template': 'textarea.HTML'})# linenos = BooleanFIEld(required=False)# language = ChoiceFIEld(choices=[('Clipper','FoxPro'),('Cucumber','Gherkin'),('RobotFramework','RobotFramework'),('abap','ABAP'),('ada','Ada')...# style = ChoiceFIEld(choices=[('autumn','autumn'),('borland','borland'),('bw','bw'),('colorful','colorful')...
和手动定义的字段一模一样。其实ModelSerializer并没有做额外的处理,我们可以从它的部分代码片段看到:
serializer_fIEld_mapPing = { models.autoFIEld: IntegerFIEld,models.BigIntegerFIEld: IntegerFIEld,models.BooleanFIEld: BooleanFIEld,# Default `create` and `update` behavior... def create(self,valIDated_data): def update(self,valIDated_data): raise_errors_on_nested_writes('update',self,valIDated_data)
建立字段映射,定义create()
和update()
等方法,只做了最简单的封装。
我们之前用的是已经封装好的rest_framework.vIEwsets,这里直接用Django原生的vIEw。在snippets/vIEws.py
中添加代码:
from django.http @R_301_5565@ httpResponse,JsonResponsefrom django.vIEws.decorators.csrf @R_301_5565@ csrf_exemptfrom rest_framework.parsers @R_301_5565@ JsONParserfrom snippets.models @R_301_5565@ Snippetfrom snippets.serializers @R_301_5565@ SnippetSerializer
先创建snippet_List视图,返回snippets列表或者新建1个snippet:
@csrf_exemptdef snippet_List(request): """ List all code snippets,or create a new snippet. """ if request.method == 'GET': snippets = Snippet.objects.all() serializer = SnippetSerializer(snippets,many=True) return JsonResponse(serializer.data,safe=False) elif request.method == 'POST': data = JsONParser().parse(request) serializer = SnippetSerializer(data=data) if serializer.is_valID(): serializer.save() return JsonResponse(serializer.data,status=201) return JsonResponse(serializer.errors,status=400)
本文示例中,客户端发起POST请求是不带CSRF token的,所以需要添加csrf_exempt(exempt翻译为免除)装饰器,允许跨域访问。这里只是演示,实际会使用django-cors-headers
来解决跨域问题,而不是给每个vIEw都加上@csrf_exempt
。
CSRF是指跨站请求伪造,攻击者盗用你的身份,以你的名义发送恶意请求。CSRF token是指服务器通过token来认证,如果请求中没有token或者token不匹配,那么就认为可能是CSRF而拒绝该请求。
接着添加一个vIEw,对单个snippet进行删(delete)、改(update)、查(retrIEve):
@csrf_exemptdef snippet_detail(request,pk): """ RetrIEve,update or delete a code snippet. """ try: snippet = Snippet.objects.get(pk=pk) except Snippet.DoesNotExist: return httpResponse(status=404) if request.method == 'GET': serializer = SnippetSerializer(snippet) return JsonResponse(serializer.data) elif request.method == 'PUT': data = JsONParser().parse(request) serializer = SnippetSerializer(snippet,data=data) if serializer.is_valID(): serializer.save() return JsonResponse(serializer.data) return JsonResponse(serializer.errors,status=400) elif request.method == 'DELETE': snippet.delete() return httpResponse(status=204)
注意,前面create返回的status为201,这里retrIEve返回的默认的200,附上几个常见状态码:
@H_403_236@200 OK - GET/PUT/PATCH:服务器成功返回用户请求的数据,该 *** 作是幂等的(IDempotent)201 CREATED - POST:用户新建数据成功204 NO content - DELETE:用户删除数据成功400 InvalID request - POST/PUT/PATCH:用户发出的请求有错误,服务器没有进行新建或修改数据的 *** 作,该 *** 作是幂等的401 Unauthorized - *:表示用户没有权限(令牌、用户名、密码错误)403 ForbIDden - *:表示用户得到授权(与401错误相对),但是访问是被禁止的
最后,添加路由,新建文件snippets/urls.py
:
from django.urls @R_301_5565@ pathfrom snippets @R_301_5565@ vIEwsurlpatterns = [ path('snippets/',vIEws.snippet_List),path('snippets/<int:pk>/',vIEws.snippet_detail),]
再配置到tutorial/urls.py
:
from django.urls @R_301_5565@ path,includeurlpatterns = [ path('',include('snippets.urls')),]
测试API启动项目:
python manage.py runserver
新开一个Terminal,安装http命令行工具:
pip install httpIE
请求snippets列表:
http http://127.0.0.1:8000/snippets/http/1.1 200 OK...[ { "ID": 1,"code": "foo = \"bar\"\n","style": "frIEndly" },{ "ID": 2,"code": "print(\"hello,world\")\n","style": "frIEndly" }]
请求ID为2的snippet:
http http://127.0.0.1:8000/snippets/2/http/1.1 200 OK...{ "ID": 2,"style": "frIEndly"}
东方说不得不说DRF的Tutorial实践性很强,基本上照着做都能敲出来,体验比较好。序列化的过程,就是模型实例→Python字典→JsON的过程。通过本文也理解了在app中models.py
→serializers.py
→vIEws.py
→urls.py
的代码编写顺序。
总结参考资料:
https://www.django-rest-framework.org/tutorial/1-serialization/
https://blog.csdn.net/yexudengzhidao/article/details/93527586
以上是内存溢出为你收集整理的揭开DRF序列化技术的神秘面纱全部内容,希望文章能够帮你解决揭开DRF序列化技术的神秘面纱所遇到的程序开发问题。
如果觉得内存溢出网站内容还不错,欢迎将内存溢出网站推荐给程序员好友。
欢迎分享,转载请注明来源:内存溢出
评论列表(0条)