目录标题
一:序列化常用字段类
字段类 | 作用 |
---|---|
CharField | 字符类型 |
BooleanField | 布尔类型 |
IntegerField | 整型类型 |
DecimalField | 浮点类型 |
ListField | {name:‘lqz’,age:19,hobby:[‘篮球’,‘足球’]} |
DictField | {name:‘lqz’,age:19,wife:{‘name’:‘刘亦菲’,‘age’:33}} |
二:常用字段参数
1.CharField字段参数
参数类型 | 作用 |
---|---|
max_length | 最大长度 |
min_lenght | 最小长度 |
allow_blank | 是否允许为空 |
trim_whitespace | 是否截断空白字符 |
2.IntegerField字段参数
参数类型 | 作用 |
---|---|
max_value | 最小值 |
min_value | 最大值 |
3.通用参数
参数类型 | 作用 |
---|---|
required | 表明该字段在反序列化时必须输入,默认True |
default | 反序列化时使用的默认值 |
allow_null | 表明该字段是否允许传入None,默认False |
validators | 该字段使用的验证器【不需要了解】 |
error_messages | 包含错误编号与错误信息的字典 |
label | 用于HTML展示API页面时,显示的字段名称 |
help_text | 用于HTML展示API页面时,显示的字段帮助提示信息 |
4.重点的2个参数
参数类型 | 作用 |
---|---|
read_only | 表明该字段仅用于序列化输出,默认False |
write_only | 表明该字段仅用于反序列化输入,默认False |
三:序列化类高级用法source
1.作用:修改序列化字段名字
2.功能:
- 1.source可以指定序列化表中的字段
book_name = serializers.CharField(max_length=8, min_length=3,source='name')
- 2.可以指定方法, 用于重命名
xx = serializers.CharField(max_length=8, min_length=3,source='xx') # xx表示表模型中得方法
- 3.跨表查询
publish_name = serializers.CharField(max_length=8,min_length=3,source='publish.name')
四:序列化类高级用法之定制序列化字段的2种方法
前端显示形式
{
"name": "西游记",
"price": 33,
"publish": {name:xx,city:xxx,email:sss}
}
方法一:
- 在序列化类中写serializerMethodField()
publish = serializers.SerializerMethodField()
def get_publish(self, obj):
# obj 是当前序列化的对象
return {'name': obj.publish.name, 'city': obj.publish.city, 'email': obj.publish.email}
- 整个代码演示:使用SerializerMethodField
class BookSerializer(serializers.Serializer):
name = serializers.CharField(max_length=8, min_length=3)
price = serializers.IntegerField(min_value=10, max_value=99)
publish_date = serializers.DateField()
# publish要序列化成 {name:北京出版社,city:北京,email:2@qq.com}
# 方式一:SerializerMethodField必须配合一个方法(get_字段名,需要接受一个参数),方法返回什么,这个字段就是什么
publish = serializers.SerializerMethodField()
def get_publish(self, obj):
# obj 是当前序列化的对象
return {'name': obj.publish.name, 'city': obj.publish.city, 'email': obj.publish.email}
# 练习,用方式一,显示所有作者对象 []
authors = serializers.SerializerMethodField()
def get_authors(self, obj):
res_list = []
for author in obj.authors.all():
res_list.append({'id': author.id, 'name': author.name, 'age': author.age})
return res_list
方法二:
- 1.在表模型中写方法
def publish_detail(self):
return {'name': self.publish.name, 'city': self.publish.city, 'email': self.publish.email}
- 2.在序列化中取
publish_detail=serializers.DictField()
- 整个代码演示:在表模型中写
# 表模型中
class Book(models.Model):
name = models.CharField(max_length=32)
price = models.DecimalField(max_digits=5, decimal_places=2)
publish_date = models.DateField(null=True)
publish = models.ForeignKey(to='Publish', on_delete=models.CASCADE)
authors = models.ManyToManyField(to='Author')
# 写了个方法,可以包装成数据属性,也可以不包
def publish_detail(self):
return {'name': self.publish.name, 'city': self.publish.city, 'email': self.publish.email}
def author_list(self):
res_list = []
for author in self.authors.all():
res_list.append({'id': author.id, 'name': author.name, 'age': author.age})
return res_list
# 序列化类中
class BookSerializer(serializers.Serializer):
name = serializers.CharField(max_length=8, min_length=3)
price = serializers.IntegerField(min_value=10, max_value=99)
publish_date = serializers.DateField()
# 方式二:在表模型中写方法
publish_detail = serializers.DictField(read_only=True)
# 练习,使用方式二实现,显示所有作者
author_list = serializers.ListField(read_only=True)
补充小知识点
- 在模型类中写逻辑代码,称之为ddd,领域驱动模型
五:有关联关系表的反序列化的数据保存
1.序列化作用的字段
publish_detail = serializers.DictField(read_only=True)
author_list = serializers.ListField(read_only=True)
2.反序列化作用的字段
publish = serializers.CharField(write_only=True)
authors = serializers.ListField(write_only=True)
3.使用继承Serializer的序列化类保存需要重写create方法
# 2 一定要重写create 【序列化类中】
def create(self, validated_data):
# validated_data 校验过后的数据
{"name":"三国1演义",
"price":19,
"publish_date": "2022-09-27",
"publish":1,
"authors":[1,2]
}
book = Book.objects.create(name=validated_data.get('name'),
price=validated_data.get('price'),
publish_date=validated_data.get('publish_date'),
publish_id=validated_data.get('publish'),
)
authors = validated_data.get('authors')
book.authors.add(*authors)
return book
六:反序列化之数据校验
1.跟forms组件很像
- 字段自己的校验
- 全局钩子
- 局部钩子
2.字段自己的校验规则
- 1.继承的是Serializer,写法如下
name=serializers.CharField(max_length=8,min_length=3,error_messages={'min_length': "太短了"})
- 2.如果继承的是ModelSerializer,写法如下
extra_kwargs = {
'name': {'max_length': 8, 'min_length': 3, 'error_messages': {'min_length': "太短了"}},
}
3.局部钩子
- 继承的是Serializer和继承的是ModelSerializer,写法一样
def validate_name(self, name):
if name.startswith('sb'):
# 校验不通过,抛异常
raise ValidationError('不能以sb卡头')
else:
return name
4.全局钩子
- 继承的是Serializer和继承的是ModelSerializer,写法一样
def validate(self, attrs):
if attrs.get('name') == attrs.get('publish_date'):
raise ValidationError('名字不能等于日期')
else:
return attrs
七:模型类序列化器(ModelSerializer)的使用
class BookModelSerializer(serializers.ModelSerializer): #ModelSerializer继承Serializer
# 不需要写字段了,字段从表模型映射过来
class Meta:
model = Book # 要序列化的表模型
# fields='__all__' # 所有字段都序列化
fields = ['name', 'price', 'publish_date', 'publish', 'authors', 'publish_detail',
'author_list'] # 列表中有什么,就是序列化哪个字段
# 给authors和publish加write_only属性
# name加max_len属性
extra_kwargs = {
'name': {'max_length': 8},
'publish': {'write_only': True},
'authors': {'write_only': True},
}
publish_detail = serializers.SerializerMethodField(read_only=True)
...
author_list = serializers.SerializerMethodField(read_only=True)
...
总结:
-
1.定义一个类继承ModelSerializer
-
2 类内部写内部内 class Meta:
-
3.在内部类中指定model(要序列化的表)
-
4.在内部类中指定fields(要序列化的字段,写__all__表示所有,不包含方法,写[一个个字段])
-
5 在内部类中指定extra_kwargs,给字段添加字段参数的
-
6 在序列化类中,可以重写某个字段,优先使用你重写的
-
name = serializers.SerializerMethodField() def get_name(self, obj): return 'sb---' + obj.name
-
7.以后不需要重写create和update,ModelSerializer写好了,兼容性更好,任意表都可以直接存
八:反序列化数据校验源码分析(了解)
# 先校验字段自己的规则(最大,最小),走局部钩子校验,走全局钩子
# 局部:validate_name,全局叫:validate 为什么?
# 入口:从哪开始看,哪个操作,执行了字段校验ser.is_valid()
-BaseSerializer内的is_valid()方法
def is_valid(self, *, raise_exception=False):
if not hasattr(self, '_validated_data'):
try:
# 真正的走校验,如果成功,返回校验过后的数据
self._validated_data = self.run_validation(self.initial_data)
except ValidationError as exc:
return not bool(self._errors)
-内部执行了:self.run_validation(self.initial_data)---》本质执行的Serializer的
-如果你按住ctrl键,鼠标点击,会从当前类中找run_validation,找不到会去父类找
-这不是代码的执行,代码执行要从头开始找,从自己身上再往上找
def run_validation(self, data=empty):
#局部钩子的执行
value = self.to_internal_value(data)
try:
# 全局钩子的执行,从根上开始找着执行,优先执行自己定义的序列化类中得全局钩子
value = self.validate(value)
except (ValidationError, DjangoValidationError) as exc:
raise ValidationError(detail=as_serializer_error(exc))
return value
-全局钩子看完了,局部钩子---》 self.to_internal_value---》从根上找----》本质执行的Serializer的
def to_internal_value(self, data):
for field in fields: # fields:序列化类中所有的字段,for循环每次取一个字段对象
# 反射:去self:序列化类的对象中,反射 validate_字段名 的方法
validate_method = getattr(self, 'validate_' + field.field_name, None)
try:
# 这句话是字段自己的校验规则(最大最小长度)
validated_value = field.run_validation(primitive_value)
# 局部钩子
if validate_method is not None:
validated_value = validate_method(validated_value)
except ValidationError as exc:
errors[field.field_name] = exc.detail
return ret
# 你自己写的序列化类---》继承了ModelSerializer---》继承了Serializer---》BaseSerializer---》Field
九:断言
1.定义:
- 判断,断定一个变量必须的值,如果不是就报错
2.案例:
name = 'lqz1'
assert name == 'lqz', 'name不等于lqz'
print('程序执行完了')
作业1
- 继承ModelSerializer写五个接口
models.py定制序列化类
def publish_de(self):
return {'name': self.publish.name, 'city': self.publish.city, 'email': self.publish.email}
def author_li(self):
res_list = []
for author in self.authors.all():
res_list.append({'id': author.id, 'name': author.name, 'age': author.age})
return res_list
serializer.py
class BookModelSerializer(serializers.ModelSerializer):
class Meta:
model = Book
fields = ['name', 'price', 'publish_date', 'publish', 'authors', 'publish_de', 'author_li']
extra_kwargs = {
'name': {'max_length': 8, 'min_length': 3,
'error_messages': {'min_length': "最短长度不能小于3", 'max_length': '最大长度不能超过8'}
},
'publish': {'write_only': True},
'authors': {'write_only': True},
'price': {'max_value': 199, 'min_value': 9}
}
def validate_name(self, name):
if 'sb' in name:
raise ValidationError('名字中不能出现sb')
else:
return name
def validate_price(self, price):
if price == 66:
raise ValidationError('书的价格不能是66')
else:
return price
作业2
- 继承Serializer写五个接口
serializer.py
class BookSerializer(serializers.Serializer):
name = serializers.CharField(max_length=8, min_length=3)
price = serializers.IntegerField(max_value=199, min_value=9)
publish_date = serializers.DateField()
publish = serializers.SerializerMethodField()
def get_publish(self, obj):
# obj 是当前序列化的对象
return {'name': obj.publish.name, 'city': obj.publish.city, 'email': obj.publish.email}
authors = serializers.SerializerMethodField()
def get_authors(self, obj):
res_list = []
for author in obj.authors.all():
res_list.append({'id': author.id, 'name': author.name, 'age': author.age})
return res_list
publish = serializers.CharField(write_only=True)
authors = serializers.ListField(write_only=True)
def create(self, validated_data):
# validated_data 校验过后的数据
book = Book.objects.create(name=validated_data.get('name'),
price=validated_data.get('price'),
publish_date=validated_data.get('publish_date'),
publish_id=validated_data.get('publish'),
)
authors = validated_data.get('authors')
book.authors.add(*authors)
return book
def update(self, instance, validated_data):
instance.name = validated_data.get('name')
instance.price = validated_data.get('price')
instance.publish_data = validated_data.get('publish_date')
instance.publish_id = validated_data.get('publish')
instance.authors.set(validated_data.get('authors'))
instance.save()
return instance
views.py
from rest_framework.views import APIView
from .models import Book
# from app01.serializer import BookModelSerializer
from app01.serializer import BookSerializer
from rest_framework.response import Response
class BookView(APIView):
# 查看所有数据
def get(self, request):
book = Book.objects.all()
ser = BookSerializer(instance=book, many=True)
# ser = BookModelSerializer(instance=book, many=True)
return Response(ser.data)
# 新增数据
def post(self, request):
ser = BookSerializer(data=request.data)
# ser = BookModelSerializer(data=request.data)
if ser.is_valid():
ser.save()
return Response(ser.data)
else:
return Response(ser.errors)
class BookDetailView(APIView):
def get(self, request, pk):
book = Book.objects.filter(pk=pk).first()
ser = BookSerializer(instance=book)
# ser = BookModelSerializer(instance=book)
return Response(ser.data)
def put(self, request, pk):
book = Book.objects.filter(pk=pk).first()
ser = BookSerializer(instance=book, data=request.data)
# ser = BookModelSerializer(instance=book, data=request.data)
if ser.is_valid():
ser.save()
return Response(ser.data)
else:
Response(ser.errors)
def delete(self, request, pk):
Book.objects.filter(pk=pk).delete()
return Response({'code': 100, 'msg': '删除成功'})
作业3
- 出版社,作者,作者详情,5个接口写完
class AuthorModelSerializer(serializers.ModelSerializer):
class Meta:
model = Author
fields = ['name', 'age', 'author_de']
extra_kwargs = {
'author_de': {'read_only': True},
}
class AuthorView(APIView):
def get(self, request):
author_list = Author.objects.all()
ser = AuthorModelSerializer(instance=author_list, many=True)
return Response(ser.data)
def post(self, request):
ser = AuthorModelSerializer(data=request.data)
if ser.is_valid():
ser.save()
return Response(ser.data)
else:
return Response(ser.errors)
class AuthorDetailView(APIView):
def get(self, request, pk):
author_list = Author.objects.filter(pk=pk).first()
ser = AuthorModelSerializer(instance=author_list)
return Response(ser.data)
def put(self, request, pk):
auth_list = Author.objects.filter(pk=pk).first()
ser = AuthorModelSerializer(instance=auth_list, data=request.data)
if ser.is_valid():
ser.save()
return Response(ser.data)
else:
return Response(ser.errors)
def delete(self, request, pk):
Author.objects.filter(pk=pk).delete()
return Response({'code': 100, 'msg': '删除成功'})