django--restframework 序列化

1.djangorestframework 序列化

---

1.1序列化常用字段参数

• 选项参数

  name = serializers.CharField(min_length=3,max_length=20)
  max_length     # 最大长度
  min_lenght     # 最小长度
  allow_blank    # 是否允许为空
  max_value      # 最大值
  min_value      # 最小值 
  

• 通用参数

  gp = serializers.SerializerMethodField(read_only=True) 
  read_only     # 表明该字段仅用于序列化输出，默认False
  write_only    # 表明该字段仅用于反序列化输入，默认False
  required      # 表明该字段在反序列化时必须输入，默认True
  default       # 反序列化时使用的默认值
  allow_null    # 表明该字段是否允许传入None，默认False
  validators    # 该字段使用的验证器
  label         # 用于HTML展示API页面时，显示的字段名称
  help_text     # 用于HTML展示API页面时，显示的字段帮助提示信息
  error_messages    # 包含错误编号与错误信息的字典
  

2.序列化使用（ serializers.Serializer ）

---

1）序列化（正向查找）

from rest_framework import serializers
from users.models import UserInfo

class UserInfoSerializer(serializers.Serializer):
    name = serializers.CharField(min_length=3,max_length=20)               # 显示普通字段
    ut = serializers.CharField(source='ut.type_name',required=False)       # 显示一对多字段名称 **一对多字段需要写source='字段名.表名',required=False***
    gp = serializers.SerializerMethodField(read_only=True)                 # 自定义显示（显示多对多）
    xxx = serializers.CharField(source='name',required=False)              # 也可以自定义显示字段名称
    ut_id = serializers.IntegerField(write_only=True)                      # 一对多关联字段定义(外键约束)

    '''PrimaryKeyRelatedField和StringRelatedField：可以用对 一对多 和 多对多 关联对象序列化'''
    # gp = serializers.PrimaryKeyRelatedField(read_only=True, many=True)
    # gp = serializers.StringRelatedField(read_only=True,many=True)

    class Meta:
        model = UserInfo

    # 自定义显示 多对多 字段    **自定义字段需要写这个**
    def get_gp(self,row):
        '''row: 传过来的正是 UserInfo表的对象'''
        gp_obj_list = row.gp.all().values('id','group')  # 获取用户所有组
        return gp_obj_list

2）序列化（反向查找）

''' 一对多序列化（反向查找）'''
class UserTypeSerializer(serializers.Serializer):
    type_name = serializers.CharField()
    # 方法1一对多关联对象序列化：此字段将被序列化为关联对象的主键
    userinfo_set = serializers.PrimaryKeyRelatedField(read_only=True, many=True)

    # 方法2一对多关联对象序列化：此字段将被序列化为关联对象的字符串表示方式（即__str__方法的返回值）
    # userinfo_set = serializers.StringRelatedField(read_only=True,many=True)
    # 方法3一对多关联对象序列化：使用关联对象的序列化器
    # userinfo_set = UserInfoSerializer(many=True)

3）视图函数中使用序列化

class UserInfoViewSet(APIView):
    def get(self, request, *args, **kwargs):
        # 一对多、多对多查询都是一样的语法
        obj = users_model.UserInfo.objects.all()
        ser = serializers.UserInfoSerializer(instance=obj,many=True)  # 关联数据多条
        # ser = serializers.UserInfoSerializer(instance=obj[0])       # 关联数据一条
        return Response(ser.data, status=200)

3、反序列化

---

1）使用反序列化保存数据

'''创建用户'''
def post(self,request):
    ser = serializers.UserInfoSerializer(data=request.data)
    if ser.is_valid():
        ser.save()
        return Response(data=ser.data, status=201)
    return Response(data=ser.errors,status=400)

2）反序列化定义创建和更新方法

# 定义创建语法
    def create(self, validated_data):
        return UserInfo.objects.create(**validated_data)

    # 定义更新方法
    def update(self, instance, validated_data):
        if validated_data.get('name'):
            instance.name = validated_data['name']
        if validated_data.get('ut_id'):
            instance.ut_id = validated_data['ut_id']
        instance.save()
        return instance

    # 定义单一字段验证的方法
    def validate_name(self, value):
        if value == 'root':
            raise serializers.ValidationError('不能创建root管理员账号')
        return value

    # 定义多字段验证方法
    def validate(self, attrs):
        if attrs['name'] == 'admin':
            raise serializers.ValidationError('不能创建admin用户')
        return attrs

4、序列化使用举例（serializers.ModelSerializer）

---

1. ModelSerializer本质是继承了Serielizer类添加了部分功能

2. 在使用上ModelSerializer可以使用 fields = 'all' 定义要显示的字段

serializers.ModelSerializer使用

'''users/serializers/userinfo_serializers.py'''

from rest_framework import serializers
from users.models import UserInfo

class UserInfoSerializer(serializers.ModelSerializer):
    # name = serializers.CharField()                       # 显示普通字段
    ut = serializers.CharField(source='ut.type_name')     # 显示一对多字段
    gp = serializers.SerializerMethodField()               # 自定义显示（显示多对多）
    xxx = serializers.CharField(source='name')             # 也可以自定义显示字段名称

    class Meta:
        model = UserInfo
        # fields = "__all__"
        fields = ["name",'ut','gp','xxx']  # 定义显示那些字段

    def get_gp(self,row):
        '''row: 传过来的正是 UserInfo表的对象'''
        gp_obj_list = row.gp.all()  # 获取用户所有组
        ret = []
        for item in gp_obj_list:
            ret.append({'id':item.id,'gp':item.group})
        return ret

5、使用serializers.ModelSerializer 进行数据验证

---

users/views.py

from rest_framework.views import APIView
from users.serializers.userinfo_serializers import UserInfoSerializer
from users.models import UserInfo

class UserInfoViewSet(APIView):
    def get(self, request, *args, **kwargs):
        obj = UserInfo.objects.all()
        ser = UserInfoSerializer(instance=obj,many=True)
        ret = json.dumps(ser.data,ensure_ascii=False)
        return HttpResponse(ret)

    def post(self, request, *args, **kwargs):
        ser = UserInfoSerializer(data=request.data)          # 验证，对请求发来的数据进行验证
        if ser.is_valid():
            print(ser.validated_data)  # post请求数据字典
        else:
            print(ser.errors)  # form验证错误信息
        return HttpResponse(json.dumps({'status':True}))

users/serializers/userinfo_serializers.py

'''users/serializers/userinfo_serializers.py'''

from rest_framework import serializers
from django.core.exceptions import ValidationError
from users.models import UserInfo

class UserInfoSerializer(serializers.ModelSerializer):
    name = serializers.CharField(min_length=10, error_messages={'required': '该字段必填'})                       # 显示普通字段
    ut = serializers.CharField(source='ut.type_name',required=False)     # 显示一对多字段
    gp = serializers.SerializerMethodField(required=False)               # 自定义显示（显示多对多）
    xxx = serializers.CharField(source='name', required=False)             # 也可以自定义显示字段名称

    class Meta:
        model = UserInfo
        # fields = "__all__"
        fields = ["name",'ut','gp','xxx']  # 定义显示那些字段

    # 局部钩子:
    def validate_name(self, value):  # value 是name字段提交的值
        if value.startswith('sb'):  # 不能以sb开头
            raise ValidationError('不能以sb开头')
        else:
            return value

    # 全局钩子找到了
    def validate(self, value):  # value是所有校验通过数据的字典
        name = value.get('name')
        if False:
            raise ValidationError('全局钩子引发异常')
        return value

'''1、ser.is_valid()'''
# 验证post请求中数据是否合法

'''2、全局校验钩子'''
def validate(self, value):        # value是所有校验通过数据的字典

'''3、局部钩子'''
def validate_name(self, value):   # value 是name字段提交的值