序列化与反序列化

Serializer字段和选项
字段
- 定义Serializer类
Django REST framework中的Serializer使用类来定义，须继承自rest_framework.serializers.Serializer。
例如，我们已有了一个数据库模型类BookInfo
class BookInfo(models.Model):
name = models.CharFie

ld(max_length=20, verbose_name=’名称’) #图书名称
pub_date = models.DateField(verbose_name=’发布日期’) #发布日期
readcount = models.IntegerField(default=0, verbose_name=’阅读量’) #阅读量
commentcount = models.IntegerField(default=0, verbose_name=’评论量’) #评论量
is_delete = models.BooleanField(default=False, verbose_name=’逻辑删除’) #逻辑删除
image = models.ImageField(upload_to=’book/’, verbose_name=’图片’, null=True)
#元类信息 : 修改表名
class Meta:
db_table = ‘bookinfo’ # 指明数据库表名
verbose_name = ‘图书’ # 在admin站点中显示的名称
verbose_name_plural = verbose_name # 显示的复数名称

def __str__(self):
    """定义每个数据对象的显示信息"""
    return self.name

我们想为这个模型类提供一个序列化器，可以定义如下：

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)
注意：serializer不是只能为数据库模型类定义，也可以为非数据库模型类的数据定义。serializer是独立于数据库之外的存在。

2. 字段与选项
常用字段类型：

字段 字段构造方式
BooleanField BooleanField()
NullBooleanField NullBooleanField()
CharField CharField(max_length=None, min_length=None, allow_blank=False, trim_whitespace=True)
EmailField EmailField(max_length=None, min_length=None, allow_blank=False)
RegexField RegexField(regex, max_length=None, min_length=None, allow_blank=False)
SlugField SlugField(maxlength=50, min_length=None, allow_blank=False) 正则字段，验证正则模式 [a-zA-Z0-9-]+
URLField URLField(max_length=200, min_length=None, allow_blank=False)
UUIDField UUIDField(format=’hex_verbose’) format: 1)’hex_verbose’如”5ce0e9a5-5ffa-654b-cee0-1238041fb31a” 2）’hex’如”5ce0e9a55ffa654bcee01238041fb31a” 3）’int’- 如:”123456789012312313134124512351145145114” 4）’urn’如:”urn:uuid:5ce0e9a5-5ffa-654b-cee0-1238041fb31a”
IPAddressField IPAddressField(protocol=’both’, unpack_ipv4=False, **options)
IntegerField IntegerField(max_value=None, min_value=None)
FloatField FloatField(max_value=None, min_value=None)
DecimalField DecimalField(max_digits, decimal_places, coerce_to_string=None, max_value=None, min_value=None) max_digits: 最多位数 decimal_palces: 小数点位置
DateTimeField DateTimeField(format=api_settings.DATETIME_FORMAT, input_formats=None)
DateField DateField(format=api_settings.DATE_FORMAT, input_formats=None)
TimeField TimeField(format=api_settings.TIME_FORMAT, input_formats=None)
DurationField DurationField()
ChoiceField ChoiceField(choices) choices与Django的用法相同
MultipleChoiceField MultipleChoiceField(choices)
FileField FileField(max_length=None, allow_empty_file=False, use_url=UPLOADED_FILES_USE_URL)
ImageField ImageField(max_length=None, allow_empty_file=False, use_url=UPLOADED_FILES_USE_URL)
ListField ListField(child=, min_length=None, max_length=None)
DictField DictField(child=)
选项参数：

参数名称 作用
max_length 最大长度
min_lenght 最小长度
allow_blank 是否允许为空
trim_whitespace 是否截断空白字符
max_value 最小值
min_value 最大值
通用参数：
参数名称 说明
read_only 表明该字段仅用于序列化输出，默认False
write_only 表明该字段仅用于反序列化输入，默认False
required 表明该字段在反序列化时必须输入，默认True
default 反序列化时使用的默认值
allow_null 表明该字段是否允许传入None，默认False
validators 该字段使用的验证器
error_messages 包含错误编号与错误信息的字典
label 用于HTML展示API页面时，显示的字段名称
help_text 用于HTML展示API页面时，显示的字段帮助提示信息
3. 创建Serializer对象
定义好Serializer类后，就可以创建Serializer对象了。

Serializer的构造方法为：

Serializer(instance=None, data=empty, **kwarg)
说明：

1）用于序列化时，将模型类对象传入instance参数

2）用于反序列化时，将要被反序列化的数据传入data参数

3）除了instance和data参数外，在构造Serializer对象时，还可通过context参数额外添加数据，如
serializer = AccountSerializer(account, context={‘request’: request})
通过context参数附加的数据，可以通过Serializer对象的context属性获取。

POST 请求———> 反序列化过程——->
deserializer: Json → native datatype【data = JSONParser().parse(BytesIO(content))】 → isntance【serializer = SnippetSerializer(data=data) serializer.is_valid()# True serializer.save()】
GET 请求 ———-> 序列化过程———->
serilization : isntance(django 模型实例) → native datatype（python 原生数据类型）【serializer.data】 → Json【JSONRenderer().render(serializer.data)】，将model实例的转为json格式response出去。
从REST的设计原则看，它实际上是为了满足客户端的需求，现在的web后端与客户端（ios/android）打交道的多，这样的格式化response更便于它们解析。换句话说就是：将response打包成某种格式（如JSON)的东西。