序列化组件的基本使用
Posted hz2lxt
tags:
篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了序列化组件的基本使用相关的知识,希望对你有一定的参考价值。
Q:序列化组件有什么用?
A:序列化阶段,能把模型对象转化成字典
? 反序列化阶段,能把客户端发送来的数据经过request变成的字典转化成模型对象,并完成校验
一、创建一个序列化器
- 在settings中注册rest_framework
- 在模型里写上序列化器要用的表
- 在应用下创建一个py文件
from rest_framework import serializers
from rest_framework.exceptions import ValidationError
from app01.models import Student
class StudentSerializer(serializers.Serializer):
name = serializers.CharField(max_length=10, min_length=5)
sex = serializers.BooleanField(default=1)
age = serializers.IntegerField(max_value=100, min_value=18)
class_null = serializers.CharField(max_length=5)
description = serializers.CharField(max_length=1000)
一个最基本的序列化器就完成了,接下来就是在视图函数中去使用了
字段类型总结:
字段 | 字段构造方式 |
---|---|
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=) |
二、使用序列化器
提醒:在返回数据的时候,我们可以用Jsonrespone,也可以用drf带的Respone,也可以自己建一个响应信息的方法,jspone和drf自带的区别就是一个是直接返回数据,一个有一个渲染好的页面
1 修改数据
class StudentAPI(APIView):
def put(self,request,pk):
back_dic = {‘code‘:200,‘msg‘:‘成功‘}
obj = models.Student.objects.filter(pk = pk).first()
ser_obj = ser.StudentSerializer(obj,request.data)
if ser_obj.is_valid():
ser_obj.save()
back_dic[‘data‘] = ser_obj.data
else:
back_dic[‘code‘] = 100
back_dic[‘msg‘] = ‘出错‘
back_dic[‘error_msg‘] = ser_obj.errors
return JsonResponse(back_dic)
我们发现在save()调用的时候发生了报错
NotImplementedError: `update()` must be implemented.
提示我们必须重写update方法,在可扩展性高的框架和方法经常会用到这种方式,让我们继承的子类实现多态,python中的多态是鸭子类型,比如你能像鸭子叫,你就能被当成鸭子去使用。
直接在序列化器中重写update方法
def update(self, instance, validated_data):
instance.name = validated_data.get(‘name‘)
instance.age = validated_data.get(‘age‘)
instance.sex = validated_data.get(‘sex‘)
instance.class_null = validated_data.get(‘class_null‘)
instance.description = validated_data.get(‘description‘)
instance.save()
return instance
同样的情况出现在提交数据的时候
2 提交数据
class StudentsAPI(APIView):
def post(self,request):
# print(request.data)
back_dic = {‘code‘: 200, ‘msg‘: ‘成功‘}
obj = ser.StudentSerializer(data = request.data)
if obj.is_valid():
obj.save()
back_dic[‘data‘] = obj.data
else:
back_dic[‘code‘] = 100
back_dic[‘msg‘] = ‘错误‘
back_dic[‘error_msg‘] = obj.errors
return (back_dic)
这里的save()在调用的时候也报错,提示我们要重写create方法,按部就班继续写
def create(self, validated_data):
obj = Student.objects.create(**validated_data)
return obj
3 校验数据
提交数据和修改数据我们都用了一个方法,is_valid()
这个方法的作用和forms组件中基本一样,就是对我们要序列化的数据进行校验
而校验的规则就在我们序列化组件当中
三种校验方式:
- 在字段后添加校验参数
- 写全局校验函数和局部校验函数
- 在类外面写验证器
3.1 字段后添加参数校验
age = serializers.IntegerField(max_value=100, min_value=18)
class_null = serializers.CharField(max_length=5)
选项参数
参数名称 | 作用 |
---|---|
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.2 全局校验与局部校验
这里需要注意一点,我们通常在这里抛出的异常都是drf给我们设定好的错误类型
全局校验传的参数是完成第一步校验的字典
局部校验传的参数是被校验的数据
最后都要把他们返回
from rest_framework.exceptions import ValidationError
def validate(self, attrs):
name = attrs.get(‘name‘)
description = attrs.get(‘description‘)
if name == description:
raise ValidationError(‘名字和签名不能一致‘)
return attrs
def validate_name(self, data):
if data.startswith(‘sb‘):
raise ValidationError(‘名字不能以sb开头‘)
return data
3.3 校验器
可以使用字段的author=serializers.CharField(validators=[check_author]) ,来校验
-写一个函数
# 写在类外
def check_author(data):
if data.startswith(‘sb‘):
raise ValidationError(‘作者名字不能以sb开头‘)
else:
return data
author=serializers.CharField(validators=[check_author])
三、模型类序列化器
class BookModelSerializer(serializers.ModelSerializer):
class Meta:
model=Book # 对应上models.py中的模型
fields=‘__all__‘
# fields=(‘name‘,‘price‘,‘id‘,‘author‘) # 只序列化指定的字段
# exclude=(‘name‘,) #跟fields不能都写,写谁,就表示排除谁
# read_only_fields=(‘price‘,)
# write_only_fields=(‘id‘,) #弃用了,使用extra_kwargs
extra_kwargs = { # 类似于这种形式name=serializers.CharField(max_length=16,min_length=4)
‘price‘: {‘write_only‘: True},
}
# 其他使用一模一样
#不需要重写create和updata方法了
四、serializers高级用法
1 参数source
放属性名
# 这里的source用法等于是修改前面的名字
# 下面的名字相当于student.name,如果参数中有source会优先使用source定义的名字
# 这里注意,source只是修改了我们查找的对应模型字段名,我们返回数据的字典中,还是name1,在前端发送数据时也应该是name1
name1 = serializers.CharField(max_length=10, min_length=5,source=‘name‘)
# 拓展,如果我们这个字段是一个外键字段,我们甚至可以点到别的表去
# 学生的模型中有一个外键字段课程sourse
sourse = serializers.CharField()
# 这个时候我们在前端展示的是一个object对象,因为这个返回的时候相当于print()了一下
# 所以我们可以在sourse模型类中去重写__str__方法,
def __str__(self):
return self.name
# 这样我们在前端看到的sourse的属性就是对应的课程名了
# 由于学生和课程的外键关联,如果我们想要这个字段拿到我们指定的值,比如说得到课程等级
# 我们可以去修改Source的__str__方法,也可以在source参数中通过点跨表查询
sourse = serializers.CharField(source=‘sourse.level‘)
# 相当于 student.sourse.level
放方法名
# source不仅可以放属性,也可以放方法,在模型类中定义的test的返回值,就是msg显示的信息
msg = serializers.CharField(source=‘test‘)
2 SerializerMethodField
description = serializers.CharField(max_length=1000)
# 当我们某些数据是需要返回一个列表或字典的,就需要用到SerializerMethodField
# 它需要一个配套的方法,名字固定叫get_xxx,xxx是前面的名字
# 这个方法除了self还有一个参数:数据对象本身,这里是student数据对象
# 这个方法的返回值就是这个名字在前端展示的样子
msg_list = serializers.SerializerMethodField()
def get_msg_list(self,data):
l1 = []
for i in range(3):
l1.append(f‘测试{i}‘)
return l1
这里的应用场景:比如我们的student表有一个多对多老师的外键关联,我们返回一个学生的信息,就可能要返回多个老师,但是普通的序列化器字段只对应一个值,我们可以通过这个方法去把数据拿出来操作,会方便很多。
3 many=True源码
def __new__(cls, *args, **kwargs):
# We override this method in order to automagically create
# `ListSerializer` classes instead when `many=True` is set.
if kwargs.pop(‘many‘, False):
return cls.many_init(*args, **kwargs)
return super().__new__(cls, *args, **kwargs)
在父类中重写了__new__
方法,当实例化对象时传进来的参数many=True,则实例化生成ListSerializer对象,如果是False,则生成Serializer对象
以上是关于序列化组件的基本使用的主要内容,如果未能解决你的问题,请参考以下文章