Django序列化器详解：普通序列化器与模型序列化器的选择与运用

2024-06-15 00:28
文章标签 序列化 django 详解 模型 运用 普通 选择

本文主要是介绍Django序列化器详解：普通序列化器与模型序列化器的选择与运用，希望对大家解决编程问题提供一定的参考价值，需要的开发者们随着小编来一起学习吧！

在这里插入图片描述

系列文章目录

  • Django入门全攻略：从零搭建你的第一个Web项目
  • Django ORM入门指南：从概念到实践，掌握模型创建、迁移与视图操作
  • Django ORM实战：模型字段与元选项配置，以及链式过滤与QF查询详解
  • Django ORM深度游：探索多对一、一对一与多对多数据关系的奥秘与实践
  • 跨域问题与Django解决方案：深入解析跨域原理、请求处理与CSRF防护
  • Django视图层探索：GET/POST请求处理、参数传递与响应方式详解
  • Django路由与会话深度探索：静态、动态路由分发，以及Cookie与Session的奥秘
  • Django API开发实战：前后端分离、Restful风格与DRF序列化器详解
  • Django序列化器详解：普通序列化器与模型序列化器的选择与运用
  • 还在写0.0…

文章目录

  • 系列文章目录
  • 前言
  • 一、普通序列化器-Serializer
    • 1. 普通序列化器编写方式
    • 2. 普通序列化器序列化
    • 3. 普通序列化器反序列化创建
    • 4. 普通序列化器反序列化更新
    • 5. 普通序列化器完整代码
  • 二、模型序列化器-ModelSerializer
    • 1. 模型序列化器编写方式
    • 2. 模型序列化器反序列化创建、更新
    • 3. 模型序列化器与普通序列化器的对比

前言

    在 Django REST framework 中，数据序列化至关重要。本文将探讨 普通序列化器 和 模型序列化器，了解它们的基本功能和差异，帮助您根据项目需求选择合适的序列化器。

Response是不能直接返回ORM数据的，所以需要我们进行序列化操作，可以通过手动将其转为字典或JSON，也可以使用DRF所提供的序列化器，一般建议使用序列化器。
如果你经常使用的是自己去将数据封装为JSON，那么常见的代码模型就像这样

data = models.objects.all()
json_data = {}
for d in data:json_data['age'] = d.agejson_data['name'] = d.name
return Response(json_data)

随字段越来越多，工作量会越来越大，而且有关于时间(DateTimeField、DateField)等字段类型的序列化直接通过JSON也是不行的，需要自己手动编写JSON的序列化器，非常麻烦，于是乎 DRF 就提供了更为便捷的两种序列化器，普通序列化器与模型序列化器

一、普通序列化器-Serializer

1. 普通序列化器编写方式

导包：from rest_framework import serializers

普通序列化器，可以按照给定字段，将所匹配的ORM数据字段转换为JSON数据，不光可以对一条数据，也可以对一个QuerySet所对应的结果集

例如：

用户表 UserModel：

#models.py
from django.db import models# Create your models here.
class UserModel(models.Model):name = models.CharField(max_length=50)phone = models.CharField(max_length=11)password = models.CharField(max_length=30)info = models.CharField(max_length=100, null=True)def __str__(self):return self.nameclass Meta:db_table = 'user'

普通序列化器UserSerializer定义如下：

#userSerializer.py
class UserSerializer(serializers.Serializer):name = serializers.CharField(max_length=50)phone = serializers.CharField(validators=[validators_phone])password = serializers.CharField(max_length=30)info = serializers.CharField(max_length=100,default="默认值")

序列化器的使用分两个阶段：
1、在客户端请求时，使用序列化器可以完成对数据的反序列化（将字典格式的数据转化为模型对象）。
2、在服务器响应时，使用序列化器可以完成对数据的序列化（将模型对象转化为字典格式的数据）。

2. 普通序列化器序列化

序列化就是将ORM数据放入序列化器加工，诞生出JSON数据对象，序列化器对象的data属性即为处理好的 JSON 数据对象

1、单条数据的序列化：

  • 单挑数据的序列化很简单，直接通过序列化器类对象的参数instance传入查询得到的结果即可
#views.py
class UserIdView(APIView):def get(self, request, id):user = UserModel.objects.get(pk=id)usSer = UserSerializer(instance=user)return Response({"message": "get测试成功！", "data": usSer.data})

2、多条数据的序列化：

  • 如果使用像filter、all这样的一些ORM方法，获取到的是QuerySet结果集，不是单独数据对象，那么使用序列化器时，需要传入many=True参数，用来表示：传入的不止一条数据。
#views.py
class UserView(APIView):def get(self, request):users = UserModel.objects.all()usSer = UserSerializer(instance=users, many=True)return Response({"message":"get测试成功！","data":usSer.data})

Serializer属性中选项参数

选项参数名称作用
max_length最大长度
min_length最小长度
allow_blank是否允许为空
trim_whitespace是否截断空白字符
max_value最大值
min_value最小值
通用参数名称作用
read_only该字段仅用于序列化输出，需要序列化输出时设置：read_only=True;默认为False
write_only该字段仅用于反序列输入，需要序列化输入时设置：write_only=True;默认为False
required该字段表示在反序列化输入时必须输入
default反序列化时使用的默认值
allow_null表明该字段是否允许传入None，默认False
validators对字段进行校验，定义在字段中
error_message当字段校验不通过时，报error_message的value值
label用于HTML展示API页面时，显示的字段名称
help_text用于HTML展示API页面时，显示的字段帮助提示信息

3. 普通序列化器反序列化创建

反序列化的概念很简单，就是把JSON等数据变为ORM数据对象，甚至是入库或者是修改

DRF要求序列化器必须对数据进行校验，才能获取验证成功的数据或保存成模型类对象

  1. 在操作过程中，反序列化首先需要通过data 传参
  2. 接着调用is_valid进行校验，验证成功返回True，反之返回False
    • 如果校验失败，还可以通过结果的errors 属性返回错误值
    • is_valid调用后方法会进行字段属性(max_value=10)的校验、自定义的校验等等
  3. 对校验过后的对象调用save方法，这个save方法会触发序列化器中的create方法
    • 普通序列化器中，create方法默认是没有实现的，需要手动根据模型类进行编写

如果需要自定义校验规则，可以通过validators实现：

#userSerializer.py
from rest_framework import serializers
from app.models import UserModel
import redef validators_phone(values):r_phone = r"^1[3-9]\d{9}$"if re.match(r_phone, values):print("手机号匹配成功！")else:print("手机号匹配失败，抛出异常！")raise serializers.ValidationError("手机号匹配失败！不满足规则！")class UserSerializer(serializers.Serializer):name = serializers.CharField(max_length=50)phone = serializers.CharField(validators=[validators_phone])password = serializers.CharField(max_length=30)info = serializers.CharField(max_length=100,default="默认值")

比如现在，需要提交数据用到创建User的接口，此时可以这么做
为了能够保证数据成功入库，默认的普通序列化器是不具备入库功能的，需要编写create方法

#userSerializer.py
class UserSerializer(serializers.Serializer):name = serializers.CharField(max_length=50)phone = serializers.CharField(validators=[validators_phone])password = serializers.CharField(max_length=30)info = serializers.CharField(max_length=100,default="默认值")def create(self, validated_data):object = UserModel.objects.create(**validated_data)return object#具体来说，**validated_data的作用是：解包字典。
#它将validated_data字典中的键值对解包为一系列的关键字参数。

成功之后，就可以通过像之前一样的数据提交，编写视图完成数据入库，序列化器可以直接处理request所提交的数据data，并且可以剔除在request.data中其他多余的字段，只会处理序列化器里的字段

# views.py
class UserView(APIView):def post(self, request):ser = UserSerializer(data=request.data) # 传参data，进行反序列化if ser.is_valid():print("校验成功！")ser.save()return Response({"message":"[POST]信息添加成功！"})else:print("校验失败！")return Response({"message": ser.errors})

4. 普通序列化器反序列化更新

反序列化经过校验的数据，不光可以用来创建数据，还可以用来更新数据

  • 更新首先需要一个已经存在的数据，所以需要通过instance参数传递已有的一个ORM对象
  • 还需要待更新的新值，那么就需要传data参数
  • 之后同样需要is_valid方法调用，检查即将更新进入的数据是否合法
  • 最终save触发序列化器中的update方法

默认普通序列化器是没有自带对于数据的更新方法的，现在需要在序列化器里创建update方法

# userSerializer.py
class UserSerializer(serializers.Serializer):name = serializers.CharField(max_length=50)phone = serializers.CharField(validators=[validators_phone])password = serializers.CharField(max_length=30)info = serializers.CharField(max_length=100,default="默认值")def update(self, instance, validated_data):# instance 要更新的数据，validated_data 是新数据instance.name = validated_data.get('name', instance.name)instance.phone = validated_data.get('phone', instance.phone)instance.password = validated_data.get('password', instance.password)instance.info = validated_data.get('info', instance.info)instance.save()return instance#获取字段值：
#validated_data.get('name') 尝试从 validated_data 字典中获取键为 'name' 的值。
#validated_data 是由序列化器在验证请求数据后生成的一个字典，它包含了经过验证的字段和它们的值。#默认值机制：
#get 方法有一个可选的第二个参数，即默认值。如果 'name' 这个键不存在于validated_data 中，get 方法将返回这个默认值。
#在这个例子中，如果请求数据中没有包含 'name' 字段，那么默认值就是 instance.name，即当前模型实例的 name 字段的值。

然后通过PUT传递要更新数据的ID，以及更新后的值，来为某条数据更新

class UserIdView(APIView):def put(self, request, id):user = UserModel.objects.get(pk=id)ser = UserSerializer(instance=user, data=request.data)if ser.is_valid():print("校验成功！")ser.save()return Response({"message": "[PUT]信息修改成功！"})else:print("校验失败！")return Response({"message": ser.errors})

5. 普通序列化器完整代码

models.py：

from django.db import models# Create your models here.
class UserModel(models.Model):name = models.CharField(max_length=50)phone = models.CharField(max_length=11)password = models.CharField(max_length=30)info = models.CharField(max_length=100, null=True)def __str__(self):return self.nameclass Meta:db_table = 'user'

userSerializer.py：

from rest_framework import serializers
from app.models import UserModel
import redef validators_phone(values):r_phone = r"^1[3-9]\d{9}$"if re.match(r_phone, values):print("手机号匹配成功！")else:print("手机号匹配失败，抛出异常！")raise serializers.ValidationError("手机号匹配失败！不满足规则！")class UserSerializer(serializers.Serializer):name = serializers.CharField(max_length=50)phone = serializers.CharField(validators=[validators_phone])password = serializers.CharField(max_length=30)info = serializers.CharField(max_length=100,default="默认值")def create(self, validated_data):object = UserModel.objects.create(**validated_data)return objectdef update(self, instance, validated_data):# instance 要更新的数据，validated_data 是新数据instance.name = validated_data.get('name', instance.name)instance.phone = validated_data.get('phone', instance.phone)instance.password = validated_data.get('password', instance.password)instance.info = validated_data.get('info', instance.info)instance.save()return instance

views.py：

from rest_framework.views import APIView
from rest_framework.response import Response
from app.models import UserModel
from app.serializer.userSerializer import UserSerializer
from django.shortcuts import render# Create your views here.class UserView(APIView):def get(self, request):users = UserModel.objects.all()usSer = UserSerializer(instance=users, many=True)return Response({"message":"get测试成功！","data":usSer.data})def post(self, request):ser = UserSerializer(data=request.data) # 传参data，进行反序列化if ser.is_valid():print("校验成功！")ser.save()return Response({"message":"[POST]信息添加成功！"})else:print("校验失败！")return Response({"message": ser.errors})class UserIdView(APIView):def get(self, request, id):user = UserModel.objects.get(pk=id)usSer = UserSerializer(instance=user)return Response({"message": "get测试成功！", "data": usSer.data})def put(self, request, id):user = UserModel.objects.get(pk=id)ser = UserSerializer(instance=user, data=request.data)if ser.is_valid():print("校验成功！")ser.save()return Response({"message": "[PUT]信息修改成功！"})else:print("校验失败！")return Response({"message": ser.errors})

urls.py：

from django.urls import path
from app.views import UserView,UserIdViewurlpatterns = [path('user/', UserView.as_view()),path('user/<int:id>/', UserIdView.as_view()),
]

二、模型序列化器-ModelSerializer

1. 模型序列化器编写方式

之前的普通序列化器，很明显可以感觉到，如果模型类字段少了，还行，但是模型字段越来越多，那么开发者在序列化器里所要复刻的字段也要越来越多，很麻烦， 而且还得手动实现update和create方法，而且光写了序列化器字段还不行，还得有字段属性

于是乎，有了现在的与模型类关联的序列化器，可以更加方便的进行字段映射以及内置方法的编写

模型类关联序列化器大概总结有如下三个特性，一个缺点：

  • 特点：
    • 基于模型类自动生成一系列字段
    • 自动生成的系列字段，同时还包含unique、max_length等属性校验
    • 包含默认的create和update的实现
  • 缺点：
    • 不会自动映射模型类字段的default属性

模型类关联的序列化器用的是新的序列化器基类：

from rest_framework.serializers import ModelSerializer

用户模型类依旧使用上文中的UserModel.py文件

按照之前的普通序列化写法，你需要同步一个字段，并将字段属性也要记得同步，非常麻烦,但通过与模型类关联的序列化器就很简单了。

  1. 首先通过继承ModelSerializer基类
  2. 通过序列化器元类属性中的model属性关联模型类
  3. 通过序列化器元类属性中的fields属性指明序列化器需要处理的字段
# userModelSerializer.py
from rest_framework import serializers
from app.models import UserModelclass UserModelSerializer(serializers.ModelSerializer):# 不需要再重写 create 和 update 方法了，可查看ModelSerializer源码class Meta:model = UserModelfields = '__all__' # 指明所有模型类字段# exclude = ('password',) # 排除掉的字段# read_only_fields = ('name','info') # 只用于序列化的字段# fields = ('name','phone','password','info')# extra_kwargs = {#     'info':{'min_length':5, 'required':True},# } #修改原有字段的选项参数

模型类关联的序列化器和普通的序列化器使用方法一样，使用序列化器返回当前所有的商品数据，还是像之前一样传入instance参数即可，还要记得由于是多个商品，不是单独数据，要记得加many=True参数

2. 模型序列化器反序列化创建、更新

模型序列化器的创建就更简单了，不需要手动实现create方法，大致流程如下：

  1. 为序列化器绑定数据，ser=Serializer(data=request.data)
  2. 校验数据，ser.is_valid()
  3. 存储入库，ser.save()

创建用户接口：

from rest_framework.views import APIView
from rest_framework.response import Response
from app.models import UserModel
from app.serializer.userModelSerializer import UserModelSerializer# Create your views here.class UserView(APIView):def get(self, request):users = UserModel.objects.all()usSer = UserModelSerializer(instance=users, many=True)return Response({"message":"get测试成功！","data":usSer.data})def post(self, request):ser = UserModelSerializer(data=request.data) # 传参data，进行反序列化if ser.is_valid():print("校验成功！")ser.save()return Response({"message":"[POST]信息添加成功！"})else:print("校验失败！")return Response({"message": ser.errors})

注意： 反序列化自动生成的字段属性中，不会包含原始模型类字段中的default字段属性

更细用户信息接口：
更新某一个商品数据，模型序列化器也是自带了update方法

class UserIdView(APIView):def get(self, request, id):user = UserModel.objects.get(pk=id)usSer = UserModelSerializer(instance=user)return Response({"message": "get测试成功！", "data": usSer.data})def put(self, request, id):user = UserModel.objects.get(pk=id)ser = UserModelSerializer(instance=user, data=request.data)if ser.is_valid():print("校验成功！")ser.save()return Response({"message": "[PUT]信息修改成功！"})else:print("校验失败！")return Response({"message": ser.errors})

3. 模型序列化器与普通序列化器的对比

  • 序列化时，将模型类对象传入instance参数
    • 序列化结果使用序列化器对象的data属性获取得到
  • 反序列化创建时，将要被反序列化的数据传入data参数
    • 反序列化一定要记得先使用is_valid校验
  • 反序列化更新时，将要更新的数据对象传入instance参数，更新后的数据传入data参数
  • 模型序列化器比普通序列化器更加方便，自动生成序列化映射字段，create、update方法等
  • 关联外键序列化，字段属性外键为多时要记得加many=True

在这里插入图片描述

这篇关于Django序列化器详解：普通序列化器与模型序列化器的选择与运用的文章就介绍到这儿，希望我们推荐的文章对编程师们有所帮助！


http://www.chinasem.cn/article/1061916。

相关文章

一份LLM资源清单围观技术大佬的日常；手把手教你在美国搭建「百万卡」AI数据中心；为啥大模型做不好简单的数学计算？ | ShowMeAI日报

一份LLM资源清单围观技术大佬的日常；手把手教你在美国搭建「百万卡」AI数据中心；为啥大模型做不好简单的数学计算？ | ShowMeAI日报

👀日报&周刊合集 | 🎡ShowMeAI官网 | 🧡 点赞关注评论拜托啦！ 1. 为啥大模型做不好简单的数学计算？从大模型高考数学成绩不及格说起 司南评测体系 OpenCompass 选取 7 个大模型 (6 个开源模型+ GPT-4o)，组织参与了 2024 年高考「新课标I卷」的语文、数学、英语考试，然后由经验丰富的判卷老师评判得分。 结果如上图所
阅读更多...
mysql索引一（普通索引）

mysql索引一（普通索引）

mysql的索引分为两大类，聚簇索引、非聚簇索引。聚簇索引是按照数据存放的物理位置为顺序的，而非聚簇索引则不同。聚簇索引能够提高多行检索的速度、非聚簇索引则对单行检索的速度很快。         在这两大类的索引类型下，还可以降索引分为4个小类型：         1，普通索引：最基本的索引，没有任何限制，是我们经常使用到的索引。         2，唯一索引：与普通索引
阅读更多...
十四、观察者模式与访问者模式详解

十四、观察者模式与访问者模式详解

21.观察者模式 21.1.课程目标 1、 掌握观察者模式和访问者模式的应用场景。 2、 掌握观察者模式在具体业务场景中的应用。 3、 了解访问者模式的双分派。 4、 观察者模式和访问者模式的优、缺点。 21.2.内容定位 1、 有 Swing开发经验的人群更容易理解观察者模式。 2、 访问者模式被称为最复杂的设计模式。 21.3.观察者模式 观 察 者 模 式 ( Obser
阅读更多...
大语言模型（LLMs）能够进行推理和规划吗？

大语言模型（LLMs）能够进行推理和规划吗？

大语言模型（LLMs），基本上是经过强化训练的 n-gram 模型，它们在网络规模的语言语料库（实际上，可以说是我们文明的知识库）上进行了训练，展现出了一种超乎预期的语言行为，引发了我们的广泛关注。从训练和操作的角度来看，LLMs 可以被认为是一种巨大的、非真实的记忆库，相当于为我们所有人提供了一个外部的系统 1（见图 1）。然而，它们表面上的多功能性让许多研究者好奇，这些模型是否也能在通常需要系
阅读更多...
【操作系统】信号Signal超详解|捕捉函数

【操作系统】信号Signal超详解|捕捉函数

🔥博客主页： 我要成为C++领域大神🎥系列专栏：【C++核心编程】 【计算机网络】 【Linux编程】 【操作系统】 ❤️感谢大家点赞👍收藏⭐评论✍️ 本博客致力于知识分享，与更多的人进行学习交流 ​ 如何触发信号 信号是Linux下的经典技术，一般操作系统利用信号杀死违规进程，典型进程干预手段，信号除了杀死进程外也可以挂起进程 kill -l 查看系统支持的信号
阅读更多...
（超详细）YOLOV7改进-Soft-NMS(支持多种IoU变种选择)

（超详细）YOLOV7改进-Soft-NMS(支持多种IoU变种选择)

1.在until/general.py文件最后加上下面代码 2.在general.py里面找到这代码，修改这两个地方 3.之后直接运行即可
阅读更多...
Jitter Injection详解

Jitter Injection详解

一、定义与作用 Jitter Injection，即抖动注入，是一种在通信系统中人为地添加抖动的技术。该技术通过在发送端对数据包进行延迟和抖动调整，以实现对整个通信系统的时延和抖动的控制。其主要作用包括： 改善传输质量：通过调整数据包的时延和抖动，可以有效地降低误码率，提高数据传输的可靠性。均衡网络负载：通过对不同的数据流进行不同程度的抖动注入，可以实现网络资源的合理分配，提高整体传输效率。增
阅读更多...
人工和AI大语言模型成本对比 ai语音模型

人工和AI大语言模型成本对比 ai语音模型

这里既有AI，又有生活大道理，无数渺小的思考填满了一生。 上一专题搭建了一套GMM-HMM系统，来识别连续0123456789的英文语音。 但若不是仅针对数字，而是所有普通词汇，可能达到十几万个词，解码过程将非常复杂，识别结果组合太多，识别结果不会理想。因此只有声学模型是完全不够的，需要引入语言模型来约束识别结果。让“今天天气很好”的概率高于“今天天汽很好”的概率，得到声学模型概率高，又符合表达
阅读更多...
Steam邮件推送内容有哪些？配置教程详解！

Steam邮件推送内容有哪些？配置教程详解！

Steam邮件推送功能是否安全？如何个性化邮件推送内容？ Steam作为全球最大的数字游戏分发平台之一，不仅提供了海量的游戏资源，还通过邮件推送为用户提供最新的游戏信息、促销活动和个性化推荐。AokSend将详细介绍Steam邮件推送的主要内容。 Steam邮件推送：促销优惠 每当平台举办大型促销活动，如夏季促销、冬季促销、黑色星期五等，用户都会收到邮件通知。这些邮件详细列出了打折游戏、
阅读更多...
智能客服到个人助理，国内AI大模型如何改变我们的生活？

智能客服到个人助理，国内AI大模型如何改变我们的生活？

引言 随着人工智能（AI）技术的高速发展，AI大模型越来越多地出现在我们的日常生活和工作中。国内的AI大模型在过去几年里取得了显著的进展，不少独创的技术点和实际应用令人瞩目。 那么，国内的AI大模型有哪些独创的技术点？它们在实际应用中又有哪些出色表现呢？此外，普通人又该如何利用这些大模型提升工作和生活的质量和效率呢？本文将为你一一解析。 一、国内AI大模型的独创技术点 多模态学习 多
阅读更多...

Copyright China编程 23002807@qq.com

沪ICP备2023033072号-2