Django1.11序列化与反序列化

django序列化与反序列化

from rest_framwork import serializers

serializers.ModelSerializer

模型类序列化器，必须依据模型类创建序列化器

• 基于模型类自动生成一系列字段
• 包含默认的 crate()和update()

定义ModelSerializer类

定义序列化器

• class BookInfoSerializer(serializer.ModelSerializer):
  class Meta:
  model = BookInfo
  filels = 'all'
  read_only_fields = ('id', 'readcount', 'commentcount')
  extra_kwargs = {
  'readcount': {'min_value': 0, 'required': True},
  'commentcount': {'max_value': 0, 'required': True},
  }
  • model,指明参照的那个模型类
  • fields ，指明为模型类的那些字段生成
    • fields = ‘all’表示所有字段
    • exclude = ('iamge',) 表示排除哪些字段
    • fields = ('id','name','readcount') 表示显示哪些字段
  • read_only_fields指明只读字段，即仅用于序列化输出的字段
  • extra_kwargs,为ModelSerializer添加或修改原有的选型参数
    • extra_kwargs = {
      'readcount': {'min_value': 0, 'required': True},
      'commentcount': {'max_value': 0, 'required': True},
      }

serailizers.Serializer

即可以为数据库模型类定义，也可以为非数据库模型类的数据定义

定义Serializer类

定义序列化器

• class BookInfoSerializer(serializers.Serializers)
  id = serializers.IntegerField(label='ID', read_only=True)
• 字段和选选项

创建Serializer对象

• s = BookInfoSerializer(instance=None, data=empty, **kwarg)
  • instance:使用数据库对象赋值，用于序列化
    data：字典类型数据，用于反序列化

序列化

• 将程序中的数据结构类型转换为其他类型（字典，JSON，XML）Django中将模型类转化为JSON
• 基本使用
  • 获取需要序列化的对象
    • from book.models import BookInfo
      book = BookInfo.objects.get(id=4)
      • books = BookInfo.objects.all()
  • 构造序列化器对象
    • from book.serializers import BookInfoSerializer
      serializer = BookInfoSerializer(instance=book)
      • serializer = BookInfoSerializer(instace=books, many=True)
  • 获取序列化数据
    • serializer.data
• 关联对象嵌套序列化
  • 如果需要序列化的数据中包含有其他关联对象，则对关联对象数据的序列化需要指明
  • 关联的对象数据是一个
    • PrimaryKeyRelatedFiled
      • class PeopleInfoSerializer(serializers.Serializer):

  book = serializers.PrimaryKeyRelatedFiled(label='图书',read_only=True)

  book = serializers.PrimaryKeyRelatedFiled(label='图书',queryset=BookInfo.objects.all())
  * 包含read_only=True时，该字段不能用于反序列化使用
  * 包含queryset参数时，将被用作反序列化时参数校验使用
  * 使用序列化器对象的data方法时
  对应字段显示的是本表数据
  * {'id': 10, 'book': 3, 'description': '独孤九剑', 'gender': 1, 'name': '令狐冲'}
  * StringRelatedFiledd
  * 此字段被序列化为关联对象的字符串表示方式（即__str__方法的返回值）
  * book = serializers.StringRelatedFiled(label='图书')
  * class BookInfoSerializer(serializers.serializer):
  ...
  def str(self):
  return self.name
  * 使用序列化器对象的data方法时
  对应字段显示的关联表__str__方法返回的数据
  * {'description': '独孤九剑', 'name': '令狐冲', 'gender': 1, 'book': '笑傲江湖', 'id': 10}
  * 使用关联对象的序列化器
  * book = BookInfoSerializer()
  * 使用序列化器对象的data方法时
  对应字段显示的式OrderDict对象=有序字典
  * {'book': OrderedDict([('id', 3), ('name', '笑傲江湖'), ('pub_date', '1995-12-24'), ('readcount', 28), ('commentcount', ('image', None)]), 'gender': 1, 'name': '令狐冲', 'description': '独孤九剑', 'id': 10}
  • 关联对象的数据是多个
    • many参数
    • 使用django创建模型类的时候，一对多的一表有peopleinfo_set隐藏字段
    • 如果关联对象的数据不是只有一个，而是包含多个数据，如想序列化对应数据时，此时关联字段类型的指明仍使用上述方法，只是在声明关联字段时，多补充一个many=True参数即可
      • class BookInfoSerializer(serializers.Serializer):
        peopleinfo_set = serializers.PrimarykeyRelatedField(read_only=True,many=True)

• from book.models import BookInfo

from book.serializers import BookInfoSerializer
book = BookInfo.objects.get(id=3)
serializer = BookInfoSerializer(book)
serializer.data
{'id': 3, 'peopleinfo_set': [10, 11, 12, 13], 'commentcount': 18, 'name': '笑傲江湖', 'readcount': 28, 'pub_date': '199-24', 'image': None}

反序列化

• 与序列化相反，Django中将JSOn字符串转化为Django中的模型类对象
• 验证数据

  • from book.serializers import BookInfoSerializer

data = {'pub_date':123}
serializer = BookInfoSerializer(data=data)
serializer.is_valid()
False

serializer.errors
{'pub_date': [ErrorDetail(string='Date has wrong format. Use one of these formats instead: YYYY[-MM[-DD]].', code='invalid')], 'name': [ErrorDetail(string='This field is required.', code='required')]}

serializer.validated_data
{}

* 使用序列化器进行反序列化时，需要对数据进行验证后，才能获取

验证成功的数据或保存成模型类对象
* 序列化器对象调用is_valid()
* 通过字段类型和选型验证，验证成功返回True，失败返回False
* is_valid(raise_exception=True)
* 验证失败后抛出serializers.ValidationError
* 向前端返回HTTP 400 Bad Request响应
* 自定义验证方法
* validate_<field_name>
* 在序列化器中定义固定方法，验证单一字段
* class BookInfoSerializer(serializers.Serializer):
"""图书数据序列化器"""
id = serializers.IntegerField(label='ID', read_only=True)
peopleinfo_set = serializers.PrimaryKeyRelatedField(read_only=True, many=True) # 新增
def validate_readcount(self,value):
if value < 0:
raise serializers.ValidationError('阅读数量不能为负数')
return value
* validate
* 在序列化器中定义固定方法，验证多个字段
* class BookInfoSerializer(serializers.Serializer):
id = serializers.IntegerFiled(label='ID',read_only=True)
readcount = serializers..IntegerFiled(label='阅读量',required=False)
commentcount = serializers..IntegerFiled(label='评论量',required=False)
def validate(self,attrs):
readcount = attrs.get('readcount')
commentcount = attrs['commentcount']
if commentcount > readcount:
raise serializers.ValidationError('评论量不能大于阅读量')
returen attrs
* validators
* 在字段中添加validators选项参数，补充验证行为
* class BookInfoSerializer(serializers.Serializer):

def custom_validate(value):
    raise serializers.ValidationError('我就是来捣乱的')

"""图书数据序列化器"""
id = serializers.IntegerField(label='ID', read_only=True)
name = serializers.CharField(label='名称', max_length=20,validators=[custom_validate])
pub_date = serializers.DateField(label='发布日期', required=False)
readcount = serializers.IntegerField(label='阅读量', required=False)
commentcount = serializers.IntegerField(label='评论量', required=False)
image = serializers.ImageField(label='图片', required=False)
peopleinfo_set = serializers.PrimaryKeyRelatedField(read_only=True, many=True)  # 新增
* 序列化器对象调用errors
    * 验证失败获取错误信息
    * 验证成功，获取错误信息
* 序列化器调用validated_data
    * 验证成功获取数据

• 保存

  • 如果在验证成功后，想要基于validated_data完成数据对象的创建，可以通过实现create()和update()两个方法来实现。
    • class BookInfoSerializer(serializers.Serializer):

  """图书数据序列化器"""
  id = serializers.IntegerField(label='ID', read_only=True)
  name = serializers.CharField(label='名称', max_length=20)
  pub_date = serializers.DateField(label='发布日期', required=False)
  readcount = serializers.IntegerField(label='阅读量', required=False)
  commentcount = serializers.IntegerField(label='评论量', required=False)
  image = serializers.ImageField(label='图片', required=False)
  peopleinfo_set = serializers.PrimaryKeyRelatedField(read_only=True, many=True) # 新增

  def create(self, validated_data):
  """新建"""
  return BookInfo(**validated_data)

  def update(self, instance, validated_data):
  """更新，instance为要更新的对象实例"""
  instance.name = validated_data.get('name', instance.name)
  instance.pub_date = validated_data.get('pub_date', instance.pub_date)
  instance.readcount = validated_data.get('readcount', instance.readcount)
  instance.commentcount = validated_data.get('commentcount', instance.commentcount)
  return instance

  • 如果需要在返回数据对象的时候，也将数据保存到数据库中，则可以进行如下修改
    • class BookInfoSerializer(serializers.Serializer):

  """图书数据序列化器"""
  id = serializers.IntegerField(label='ID', read_only=True)
  name = serializers.CharField(label='名称', max_length=20)
  pub_date = serializers.DateField(label='发布日期', required=False)
  readcount = serializers.IntegerField(label='阅读量', required=False)
  commentcount = serializers.IntegerField(label='评论量', required=False)
  image = serializers.ImageField(label='图片', required=False)
  peopleinfo_set = serializers.PrimaryKeyRelatedField(read_only=True, many=True) # 新增

  def create(self, validated_data):
  """新建"""
  return BookInfo.objects.create(**validated_data)

  def update(self, instance, validated_data):
  """更新，instance为要更新的对象实例"""
  instance.name = validated_data.get('name', instance.name)
  instance.pub_date = validated_data.get('pub_date', instance.pub_date)
  instance.readcount = validated_data.get('readcount', instance.readcount)
  instance.commentcount = validated_data.get('commentcount', instance.commentcount)
  instance.save()
  return instance

  • 实现了上述两个方法后，在反序列化数据的时候，就可以通过save()方法返回一个数据对象实例了
    • serializer.save()
    • 如果创建序列化器对象的时候，没有传递instance实例，则调用save()方法的时候，create()被调用，相反，如果传递了instance实例，则调用save()方法的时候，update()被调用。

XMind: ZEN - Trial Version