DRF框架serializer之ModelSerializer
Posted xiaogongjin
tags:
篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了DRF框架serializer之ModelSerializer相关的知识,希望对你有一定的参考价值。
一、基本语法
在没有使用ModelSerializer序列化器类之前,我们定义的序列化器类都需要添加对应模型类字段的很多字段,如果添加的字段特别多,那么势必会影响开发效率和代码的可读性,因此会选择一种更为简洁的序列化器类来帮我们优化框架代码,简化序列化器类中字段的创建
常规序列化器类示例:
from rest_framework import serializers from rest_framework import validators from .models import Projects class ProjectSerializer(serializers.Serializer): name = serializers.CharField(max_length=200, label="项目名称", help_text=‘项目名称‘, validators=[validators.UniqueValidator(queryset=Projects.objects.all(), message="项目名字段name必须唯一"), name_is_not_contain_x],) leader = serializers.CharField(max_length=50, label="项目负责人", help_text=‘项目负责人‘) programmer = serializers.CharField(max_length=50, label="开发人员", help_text="开发人员") tester = serializers.CharField(max_length=50, label="测试人员", help_text="测试人员")
使用ModelSerializer如下,已经简化了很多代码:
from rest_framework import serializers from .models import Projects class ProjectsModelSerializer(serializers.ModelSerializer): class Meta: model = Projects fields = ‘__all__‘
规则总结如下:
- 需要在Meta类中使用model类属性来指定需要按照哪一个模型类来创建
- fields类属性指定模型类中哪些字段需要输入或输出
- 默认id主键会添加read_only=True
- create_time和update_time会默认添加read_only=True
- ModelSerializer类中自带的有create和update方法,无需重写即可生效
二、使用方法
直接使用ModelSerializer实例化的对象替换掉原先的序列化器类对象即可
from django.http import JsonResponse from django.views import View from django.db import connection import json from .models import Projects from .serializers import ProjectsModelSerializer class ProjectsPage(View): ‘‘‘ 类视图 ‘‘‘ def post(self, request): input_data = json.loads(request.body) serializer_check_obj = ProjectsModelSerializer(data=input_data) if not serializer_check_obj.is_valid(): return JsonResponse({"code": 1, "res": "error", "msg": serializer_check_obj.errors}) serializer_check_obj.save() return JsonResponse(serializer_check_obj.validated_data, status=201)
二、反序列化校验
1.默认全部字段输出或输入
在Meta子类中定义类属性fields=‘__all__‘
fields = ‘__all__‘
2.指定需要输出或输入的字段
在Meta子类中定义类属性fields=(字段1,字段2,......)
fields = (‘name‘, ‘leader‘, ‘programmer‘)
3.排除不需要输出或输入的字段
在Meta子类中定义类属性exclude=(字段1,字段2,......)
exclude = (‘desc‘, )
4.只允许序列化输出
在Meta子类中定义类属性read_only_fields=(字段1,字段2,......)
read_only_fields = (‘update_time‘, )
5.自定义校验规则
1).在ModelSerializer类中创建字段类的对象
其优先级最高,如果以该类方式创建的方式很多,则应该选择普通的序列化器类来定义
from rest_framework import serializers from rest_framework import validators from .models import Projects class ProjectsModelSerializer(serializers.ModelSerializer): name = serializers.CharField(max_length=200, label="项目名称", help_text=‘项目名称‘, validators=[validators.UniqueValidator(queryset=Projects.objects.all(), message="项目名字段name必须唯一")], ) class Meta: model = Projects fields = ‘__all__‘
2).在Meta子类中定义extra_kwargs字段
键为字段名,值为一个字典,其中键为校验项,值为校验规则
from rest_framework import serializers from rest_framework import validators from .models import Projects class ProjectsModelSerializer(serializers.ModelSerializer): class Meta: model = Projects fields = ‘__all__‘ extra_kwargs = { ‘name‘: { ‘max_length‘: 50, ‘validators‘: [validators.UniqueValidator(queryset=Projects.objects.all(), message="项目名字段name必须唯一")] }, ‘tester‘: { ‘max_length‘: 200 } }
三、添加不在模型类里面而需要反序列化的字段
- 定义字段
- 添加字段名称到ModelSerializer序列化器类Meta子类的fields属性中
- 在Meta子类中重写create或者update方法
from rest_framework import serializers from rest_framework import validators from .models import Projects def name_is_not_contain_x(value): if ‘X‘ in value.upper(): raise serializers.ValidationError("项目名字段name不能包含x的大小写字符") class ProjectsModelSerializer(serializers.ModelSerializer): email = serializers.EmailField(read_only=True) class Meta: model = Projects fields = (‘id‘, ‘name‘, ‘leader‘, ‘programmer‘, ‘tester‘, ‘create_time‘, ‘update_time‘, ‘email‘) extra_kwargs = { ‘name‘: { ‘max_length‘: 50, ‘validators‘: [validators.UniqueValidator(queryset=Projects.objects.all(), message="项目名字段name必须唯一"), name_is_not_contain_x] }, ‘tester‘: { ‘max_length‘: 200 } } def validate_name(self, value): if ‘项目‘ in value: raise serializers.ValidationError("项目名称name字段不能包含‘项目’字符") return value def validate(self, attrs): if ‘A‘ in attrs.get(‘name‘) and ‘B‘ in attrs.get(‘leader‘): raise serializers.ValidationError("项目名称字段name不包含A的同时项目负责人字段leader也不能包含B") return attrs def create(self, validated_data): validated_data.pop(‘email‘) return super().create(validated_data)
以上是关于DRF框架serializer之ModelSerializer的主要内容,如果未能解决你的问题,请参考以下文章