标签:刷新 sel view save 了解 from 自定义 time one
前后端分离后,其交互一般都选择使用JSON数据格式,JSON是一个轻量级的数据交互格式.
因此,后端发送给前端(或前端发送给后端)的数据都要转成JSON格式,这就得需要我们把从数据库内取到的数据进行序列化.
本文将详细讲述Django项目中如何使用第三方库rest_framework
进行序列化.
在命令行中输入:pip install djangorestframework
,方可下载rest_framework.
@
***
首先,我们准备三张数据表:
from django.db import models __all__ = ['Book', 'Publisher', 'Author'] class Book(models.Model): """书籍表""" title = models.CharField(max_length=62) CHOICES = ((1, '前端'), (2, '后端'), (3, '运维')) category = models.IntegerField(choices=CHOICES) pub_date = models.DateField() # 出版日期 publisher = models.ForeignKey(to='Publisher') # 外键出版社表 authors = models.ManyToManyField(to='Author') # 多对多作者表 class Publisher(models.Model): """出版社表""" title = models.CharField(max_length=64) class Author(models.Model): """作者表""" name = models.CharField(max_length=64)
插入数据:
# 在Python脚本中调用Django环境: import os, datetime if __name__ == '__main__': # 请将'blog091.settings'更改为对应的项目名称及配置文件,更改后直接运行即可 os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'blog091.settings') import django django.setup() from blog import models # 添加出版社 pub01 = models.Publisher.objects.create(title="上帝出版社") pub02 = models.Publisher.objects.create(title="沙河出版社") pub03 = models.Publisher.objects.create(title="西二旗出版社") # 添加作者 au01 = models.Author.objects.create(name="迷之标签大仙") au02 = models.Author.objects.create(name="迷之重启大仙") au03 = models.Author.objects.create(name="迷之算法大仙") # 添加书籍 pub_date = {'year': 2099, 'month': 12, 'day': 31} book01 = models.Book.objects.create(title="【论写标签的姿势】", category=1, pub_date=datetime.date(**pub_date), publisher=pub01) book01.authors.add(au01) book02 = models.Book.objects.create(title="【论重启服务的姿势】", category=2, pub_date=datetime.date(**pub_date), publisher=pub02) book02.authors.add(au02) book03 = models.Book.objects.create(title="【论写算法的姿势】", category=3, pub_date=datetime.date(**pub_date), publisher=pub03) book03.authors.add(au03)
既然我们要使用DRF的序列化,那么我们就得遵循人家框架的一些标准.
第一步 注册app
第二步 新建一个py文件,在文件内声明序列化类
from rest_framework import serializers class BookSerializer(serializers.Serializer): id = serializers.IntegerField() title = serializers.CharField(max_length=32) # 我们先注释掉一个字段 # 然后你读一读下面第二行黄色的字,再看一看第四步骤中的图,你就明白了. # pub_date = serializers.DateField() category = serializers.CharField(source='get_category_display')
==这里面写的字段必须是在models文件中存在的.==
==并且,在models文件中有,而在这里没有的字段会被过滤掉.==
第三步 使用CBV,序列化对象
```python
from blog import models继承类
from rest_framework.views import APIView
返回数据的方法
from rest_framework.response import Response
导入上一步骤定义的序列化类
from .serializers import BookSerializer
class Book(APIView):
def get(self, request):# 首先,我们获取书籍列表 book_list = models.Book.objects.all() # 然后,将书籍列表传入序列化类 ret = BookSerializer(book_list, many=True) # book_list:要过滤的对象列表(过滤的是字段,而不是对象) # many=True:表示取多个(源码中会循环取) # 最后返回数据 # 数据在其data中,所以要返回ret.data return Response(ret.data)
第四部 启动项目,访问站点
怎么样,四不四很66啊.
***
在声明序列化类的文件中添加如下代码:
from rest_framework import serializers class PublisherSerializer(serializers.Serializer): id = serializers.IntegerField() title = serializers.CharField(max_length=64) class AuthorSerializer(serializers.Serializer): id = serializers.IntegerField() name = serializers.CharField(max_length=32) class BookSerializer(serializers.Serializer): id = serializers.IntegerField() title = serializers.CharField(max_length=32) pub_date = serializers.DateField() category = serializers.CharField(source='get_category_display') # 出版社(外键关系) 指定上面写的出版社类即可 publisher = PublisherSerializer() # 内部通过外键关系的id找到publisher_object # 再通过PublisherSerializer(publisher_object)得到数据 # 作者(多对多关系) 指定上面写的作者类即可 authors = AuthorSerializer(many=True) # many=True:表示取多个(源码中会循环取)
然后,我们打开浏览器,狂点刷新后,即可看到:
***
当前端给我们传送数据的时候(post请求),我们要进行一些校验然后保存到数据库.
DRF中的Serializer给我们提供了一些校验和保存数据的方法,首先我们写出反序列化用到的一些字段,有些字段要跟序列化区分开来,基本步骤如下.
步骤一 声明反序列化类
·
==序列化和反序列化的字段不统一,因此我们需要分别定义序列化和反序列化的字段==from rest_framework import serializers from blog import models class PublisherSerializer(serializers.Serializer): id = serializers.IntegerField() title = serializers.CharField(max_length=64) class AuthorSerializer(serializers.Serializer): id = serializers.IntegerField() name = serializers.CharField(max_length=32) class BookSerializer(serializers.Serializer): # 序列化和反序列化的字段不统一,因此必须分别定义序列化和反序列化的字段 """ 我们先了解如下三个参数: required=False -> 反序列化时不校验此字段 read_only=True -> 反序列化时不校验此字段 write_only=True -> 序列化时不校验此字段 """ # ==== 指定序列化时校验,而反序列化时不校验的字段 ==== id = serializers.IntegerField(required=False) category = serializers.CharField(source='get_category_display', read_only=True) publisher = PublisherSerializer(read_only=True) authors = AuthorSerializer(many=True, read_only=True) # ==== 始终校验的字段 ==== title = serializers.CharField(max_length=64) pub_date = serializers.DateField() # ==== 指定反序列化时校验,而序列化时不校验的字段 ==== post_category = serializers.IntegerField(write_only=True) publisher_id = serializers.IntegerField(write_only=True) author_list = serializers.ListField(write_only=True) def create(self, validated_data): """ 用于增加数据的方法 :param validated_data: 校验通过的数据(就是步骤二中传过来的book_obj) :return: validated_data """ # 开始ORM操作: book_obj = models.Book.objects.create( title=validated_data['title'], pub_date=validated_data['pub_date'], category=validated_data['post_category'], publisher_id=validated_data['publisher_id'] ) book_obj.authors.add(*validated_data['author_list']) return validated_data
步骤二 使用CBV 反序列化对象
from blog import models # 继承类 from rest_framework.views import APIView # 返回数据的方法 from rest_framework.response import Response # 导入上一步骤定义的序列化类 from .serializers import BookSerializer class Book(APIView): def get(self, request): book_list = models.Book.objects.all() ret = BookSerializer(book_list, many=True) return Response(ret.data) # 重点在这里: def post(self, request): """post请求的基本思路:确定数据类型以及数据结构,对前端传过来的数据进行校验""" book_obj = request.data # 提取post请求发过来的数据 ser_obj = BookSerializer(data=book_obj) # data=book_obj:指定反序列化数据 if ser_obj.is_valid(): # 开始校验 ser_obj.save() # 保存数据 return Response(ser_obj.validated_data) # 校验成功,返回校验信息 return Response(ser_obj.errors) # 校验失败,返回错误信息
步骤三 启动项目 访问页面并提交JSON数据
成功后,会展示出提交的数据,如下:
***
步骤一 准备url
from blog import views urlpatterns = [ url(r'^book/(?P<book_id>\d+)$', views.BookEdit.as_view()), ]
步骤二 声明(反)序列化类
from rest_framework import serializers from blog import models class PublisherSerializer(serializers.Serializer): id = serializers.IntegerField() title = serializers.CharField(max_length=64) class AuthorSerializer(serializers.Serializer): id = serializers.IntegerField() name = serializers.CharField(max_length=32) class BookSerializer(serializers.Serializer): # 序列化和反序列化的字段不统一,因此必须分别定义序列化和反序列化的字段 """ 我们先了解如下三个参数: required=False -> 反序列化时不校验此字段 read_only=True -> 反序列化时不校验此字段 write_only=True -> 序列化时不校验此字段 """ # ==== 指定序列化时校验,而反序列化时不校验的字段 ==== id = serializers.IntegerField(required=False) category = serializers.CharField(source='get_category_display', read_only=True) publisher = PublisherSerializer(read_only=True) authors = AuthorSerializer(many=True, read_only=True) # ==== 始终校验的字段 ==== title = serializers.CharField(max_length=64) pub_date = serializers.DateField() # ==== 指定反序列化时校验,而序列化时不校验的字段 ==== post_category = serializers.IntegerField(write_only=True) publisher_id = serializers.IntegerField(write_only=True) author_list = serializers.ListField(write_only=True) def update(self, instance, validated_data): """ 用于更新数据的方法 :param instance: 要更新的数据就是步骤三中传过来的book_obj) :param validated_data: 校验通过的数据 :return: instance """ # 开始ORM操作: instance.title = validated_data.get('title', instance.title) instance.pub_date = validated_data.get('pub_date', instance.pub_date) instance.category = validated_data.get('category', instance.category) instance.publisher_id = validated_data.get('publisher_id', instance.publisher_id) if validated_data.get('author_list'): instance.authors.set(validated_data['author_list']) instance.save() return instance
步骤三 使用CBV (反)序列化对象
class BookEdit(APIView): def get(self, request, book_id): # 1. 获取指定id的数据 book_obj = models.Book.objects.filter(id=book_id).first() # 2. 过滤字段(序列化) ser_obj = BookSerializer(book_obj) # 3. 返回数据,数据在data中 return Response(ser_obj.data) # put请求 def put(self, request, book_id): book_obj = models.Book.objects.filter(id=book_id).first() # 先获取要更新的数据 ser_obj = BookSerializer(instance=book_obj, data=request.data, partial=True) # instance=book_obj:要更新的数据 # data=request.data:新的数据 # partial=True:部分校验 # ! 如果instance=None,则下面的ser_obj.save()将执行 create 方法 if ser_obj.is_valid(): ser_obj.save() # 保存数据,其内部将执行 update 方法 return Response(ser_obj.validated_data) # 校验成功,返回校验信息 return Response(ser_obj.errors) # 校验失败,返回错误信息
步骤四 启动项目 查询指定id的数据
这就是单条数据查询.
步骤五 更新指定id的数据
提交成功后,将展示出更新的数据,如下:
***
DRF为我们提供了钩子函数,可用于校验单个或多个字段.
在(反)序列化类中添加钩子函数.
def validate_title(self, value):
"""
validate_字段名, 对单个字段进行校验
:param value: 对应提交的title的值
:return:
"""
if "之" not in value:
raise serializers.ValidationError("书名必须含有 之")
return value
此时,添加/更新书籍时,如果书名中没有"之"字,则将抛出错误信息:
在(反)序列化类中添加钩子函数.
def validate(self, attrs):
"""
可对所有字段进行校验
:param attrs: 提交的所有数据
:return: 校验通过时返回attrs
"""
if attrs['post_category'] == 3 and attrs['pub_date'] == '2099-12-31':
return attrs
else:
raise serializers.ValidationError("类型必须指定 3,且出版日期必须为 2099-12-31")
此时,添加/更新书籍时,如果不符合校验规则,则将抛出错误信息.
# 首先,定义一个校验器函数
def my_validate(value):
"""自定义的校验器函数"""
if "敏感信息" in value.lower():
raise serializers.ValidationError("内容包含敏感词汇!")
class BookSerializer(serializers.Serializer):
# 然后,在校验器中调用此函数
title = serializers.CharField(max_length=64, validators=[my_validate,])
# validators=[my_validate,]:指定校验函数列表
现在,我们已经很清楚Serializer的用法了,然而我们发现,所有的序列化都跟我们的模型紧密相关...
对,没错,DRF也给我们提供了跟模型紧密相关的序列化器——ModelSerializer.
***
==根据模型自动生成字段.==
==默认就实现了添加与更新的方法.==
以下示例将实现上述的所有功能:
from rest_framework import serializers
from blog import models
class PublisherSerializer(serializers.Serializer):
id = serializers.IntegerField()
title = serializers.CharField(max_length=64)
class AuthorSerializer(serializers.Serializer):
id = serializers.IntegerField()
name = serializers.CharField(max_length=32)
def my_validate(value):
"""自定义的校验器函数"""
if "敏感信息" in value.lower():
raise serializers.ValidationError("内容包含敏感词汇!")
class BookSerializer(serializers.ModelSerializer):
""" 重写字段 + def get_自定义字段名(self, obj): """
# 重写的字段如果与原字段同名,则会覆盖掉原字段
# 外键关联的对象有很多字段我们是用不到的, 都传给前端会有数据冗余, 就需要我们自己去定制序列化外键对象的哪些字段
publisher_info = serializers.SerializerMethodField(read_only=True)
def get_publisher_info(self, obj):
# obj是要序列化的每个对象
return {'id': obj.publisher.id, 'title': obj.publisher.title}
authors_info = serializers.SerializerMethodField(read_only=True)
def get_authors_info(self, obj):
return [{'id': author.id, 'name': author.name} for author in obj.authors.all()]
# 再比如我们的选择字段,默认显示的是key, 而我们要展示给用户的是value, 因此,我们重写选择字段来自定制:
category_dis = serializers.SerializerMethodField(read_only=True)
def get_category_dis(self, obj):
return obj.get_category_display()
class Meta:
""" 指定数据表 """
model = models.Book
""" 获取字段 """
fields = "__all__" # 所有字段
# fields = ['id', 'title', '...'] # 包含指定字段
# exclude=["id", '...'] # 排除指定字段
""" depth """
# 代表找嵌套关系的第几层,指定找外键关系向下找几层
# depth = 1
# 会将所有的外键关系变成只读read_only=True
# 这个参数几乎不用,最好不要错过4层
""" 只读字段 """
# 即反序列化时不校验的字段
read_only_fields = ['id', ]
""" extra_kwargs """
# 按照下面的格式, 可为所有字段设置参数
extra_kwargs = {
"title": {"validators": [my_validate, ]},
'publisher': {'write_only': True},
'authors': {'write_only': True}
}
标签:刷新 sel view save 了解 from 自定义 time one
原文地址:https://www.cnblogs.com/ggg566/p/11414259.html