十七、Django-restframework之序列化器（二）

1. 序列化器

REST framework提供了一个serializer类，它可以非常方便的序列化模型实例和查询集为JSON或者其他内容形式。它还提供反序列化，允许在验证传入数据后将解析的数据转换回复杂类型。

2. 定义序列化器

在crm应用目录下创建serializers.py文件，编写代码如下：

from rest_framework import serializers

from crm.models import Student


class StudentSerializer(serializers.Serializer):
    """
    学生序列化器
    """
    id = serializers.IntegerField(label='学生id', read_only=True)
    name = serializers.CharField(label='姓名')
    sex = serializers.IntegerField(label='性别', default=1)
    age = serializers.IntegerField(label='年龄', required=False, allow_null=True)
    qq = serializers.CharField(label='qq号码', required=False, allow_null=True)
    phone = serializers.CharField(label='手机号码', required=False, allow_null=True)
    channel = serializers.CharField(label='渠道', read_only=True)
    c_time = serializers.DateTimeField(label='创建时间', read_only=True)

    def create(self, validated_data):
        """
        创建对象
        :param validated_data:
        :return:
        """
        return Student.objects.create(**validated_data)
    
    def update(self, instance, validated_data):
        """
        更新对象
        :param instance: 
        :param validated_data: 
        :return: 
        """
        for key, value in validated_data.items():
            setattr(instance, key, value)
        
        instance.save()
        return instance

 序列化器类的第一部分定义了要序列化/反序列化的字段。create()和update()方法定义了在调用serializer.save()时如何创建或修改实例。

3. 使用序列化器

序列化 

进入Django Shell

python manage.py shell

先导入一些需要用到的对象

from crm.models import Student
from crm.serializers import StudentSerializer
from rest_framework.renderers import JSONRenderer
from rest_framework.parsers import JSONParser

obj = Student.objects.first()

序列化这个实例

s = StudentSerializer(obj)
s.data
# {'id': 3, 'name': '赵六', 'sex': 1, 'age': 22, 'qq': '1111', 'phone': '18684720553', 'channel': '抖音', 'c_time': '2022-01-14T21:45:06.037745+08:00'}

我们已经将模型实例转换为Python原生数据类型。为了完成序列化过程，我们将数据呈现为json。

JSONRenderer().render(s.data)
# b'{"id":3,"name":"\xe8\xb5\xb5\xe5\x85\xad","sex":1,"age":22,"qq":"1111","phone":"18684720553","channel":"\xe6\x8a\x96\xe9\x9f\xb3","c_time":"2022-01-14T21:45:06.037745+08:00"}'

我们还可以序列化查询集而不是模型实例。为此，我们只需many=True向序列化程序参数添加一个标志。

ss = StudentSerializer(Student.objects.all(), many=True)
ss.data
# [OrderedDict([('id', 3), ('name', '赵六'), ('sex', 1), ('age', 22), ('qq', '1111'), ('phone', '18684720553'), ('channel', '抖音'), ('c_time', '2022-01-14T21:45:06.037745+08:00')]), OrderedDict([('id', 15), ('name', '心蓝'), ('sex', 1), ('age', 20), ('qq', '111'), ('phone', '1111123'), ('channel', '百度'), ('c_time', '2022-02-08T21:59:54.743096+08:00')]), OrderedDict([('id', 21), ('name', '西瓜'), ('sex', 1), ('age', 20), ('qq', '123456789'), ('phone', '987654321'), ('channel', '抖音'), ('c_time', '2022-02-09T21:15:37.199509+08:00')])]

反序列化

反序列化是相似的，首先将序列化数据(json)解析为原生python数据类型（省略），然后将其填充到一个序列器对象中。

里面要注意的是 当执行serializer.save()的时候，会看有没有instance这个对象 有的话就是更新，没有的话就是创建。

In [1]: from crm.serializers import StudentSerializer

In [2]: from crm.models import *

In [3]: data = {'name': '李晨', 'sex':1, 'age':18}

In [4]: serializer = StudentSerializer(data=data)

In [5]: serializer.is_valid()
Out[5]: True

In [6]: serializer.validated_data
Out[6]: OrderedDict([('name', '李晨'), ('sex', 1), ('age', 18)])

In [7]: stu = serializer.save()

In [8]: stu
Out[8]: <Student: 李晨>

4. 使用模型序列化器

我们的StudentSerializer类复制了大量Student模型中的的信息。RESTframework提供了一个ModelSerializer,它可以根据模型自动创建Serializer类，让我们的代码更简洁。再次打开crm/serializers.py模块，并用以下代码替换StudentSerializer类。

class StudentSerializer(serializers.ModelSerializer):
    class Meta:
        model = Student
        fields = ['id', 'name', 'sex', 'age', 'phone', 'qq', 'c_time']

序列化器的一个很好的属性是，您可以通过打印序列化器实例的表示形式来检查它的所有字段。进入Django shell然后尝试如下操作：

In [1]: from crm.serializers import StudentSerializer
In [2]: s = StudentSerializer()
In [3]: print(s)
StudentSerializer():
    id = IntegerField(label='ID', read_only=True)
    name = CharField(help_text='姓名', label='姓名', max_length=20)
    age = IntegerField(allow_null=True, help_text='年龄', label='年龄', max_value=32767, min_value=-32768, required=False)
    sex = IntegerField(help_text='性别', label='性别', max_value=32767, min_value=-32768, required=False)
    qq = CharField(allow_blank=True, allow_null=True, help_text='qq号码', label='Qq号码', max_length=20, required=False, validators=[<UniqueValidator(queryset=Student.objects.all())>])
    phone = CharField(allow_blank=True, allow_null=True, help_text='手机号码', label='手机号码', max_length=20, required=False, validators=[<UniqueValidator(queryset=Student.objects.all())>])
    c_time = DateTimeField(label='创建时间', read_only=True)
    channel = PrimaryKeyRelatedField(allow_null=True, help_text='渠道来源', label='渠道', queryset=Channel.objects.all(), required=False)

ModelSerializer类并没有做什么特别神奇的事情，它们只是创建serializer类的一个快捷方式:

• 一组自动确定的字段。
• create()和update()方法的简单默认实现。

5. 使用序列化器编写普通的Django视图

让我们看看如何使用我们新的序列化器类来编写一些API视图。目前我们不会使用任何REST框架的其他特性，我们只会把视图写成普通的Django视图。

编辑crm/views.py添加如下内容：

def student_list(request):
    """
    学生列表，创建学生视图
    :param request:
    :return:
    """
    if request.method == 'GET':
        objs = Student.objects.all()
        serializer = StudentSerializer(objs, many=True)
        return JsonResponse(serializer.data, safe=False)
    elif request.method == 'POST':
        data = JSONParser().parse(request)
        serializer = StudentSerializer(data=data)
        if serializer.is_valid():
            serializer.save()
            return JsonResponse(serializer.data, status=201)
        else:
            return JsonResponse(serializer.errors, status=400)


def student_detail(request, pk):
    """
    检索，更新或者删除一个学生
    :param request:
    :param pk:
    :return:
    """
    try:
        obj = Student.objects.get(pk=pk)
    except Student.DoesNotExist:
        return HttpResponse(status=404)
    if request.method == 'GET':
        serializer = StudentSerializer(obj)
        return JsonResponse(serializer.data)
    elif request.method == 'PUT':
        data = JSONParser().parse(request)
        serializer = StudentSerializer(obj, data=data)
        if serializer.is_valid():
            serializer.save()
            return JsonResponse(serializer.data)
        return JsonResponse(serializer.errors, status=400)
    elif request.method == 'DELETE':
        obj.delete()
        return HttpResponse(status=204)

 路由配置如下：

urlpatterns = [
    path('projects/', views.project_list),
    path('projects/<int:pk>/', views.project_detail)
]

那么通过/projests/和/projects/id/就可以访问对应的接口了。