django之BaseSerializer

ksuper&2024-08-19 10:05

BaseSerializer 是 Django REST framework (DRF) 中的一个核心类，用于将复杂的数据类型（如查询集和模型实例）转换为 Python 数据类型，以便于渲染成 JSON、XML 或其他内容类型。BaseSerializer 是所有序列化器的基类，提供了一些常用的方法和属性。以下是一些常用的方法和属性的介绍：

常用方法

  1. to_representation(instance)

    • 描述: 将模型实例或查询集转换为原生 Python 数据类型。

    • 用途: 用于序列化数据，即将复杂数据类型转换为简单的、可序列化的数据类型。

    • 示例 :

      python 复制代码 
      def to_representation(self, instance):
    return {
        'id': instance.id,
        'name': instance.name,
        'email': instance.email,
    }

  2. to_internal_value(data)

    • 描述: 将原生数据（通常是字典）转换为验证后的数据。

    • 用途: 用于反序列化数据，即将简单的、可序列化的数据类型转换为复杂的数据类型。

    • 示例 :

      python 复制代码 
      def to_internal_value(self, data):
    return {
        'id': data.get('id'),
        'name': data.get('name'),
        'email': data.get('email'),
    }

  3. validate(attrs)

    • 描述: 对输入数据进行验证。

    • 用途: 用于自定义验证逻辑。

    • 示例 :

      python 复制代码 
      def validate(self, attrs):
    if 'email' in attrs and not attrs['email'].endswith('@example.com'):
        raise serializers.ValidationError("Email must be from the domain 'example.com'.")
    return attrs

  4. create(validated_data)

    • 描述: 使用验证后的数据创建并返回一个新实例。

    • 用途: 用于处理创建操作。

    • 示例 :

      python 复制代码 
      def create(self, validated_data):
    return MyModel.objects.create(**validated_data)

  5. update(instance, validated_data)

    • 描述: 使用验证后的数据更新并返回一个现有实例。

    • 用途: 用于处理更新操作。

    • 示例 :

      python 复制代码 
      def update(self, instance, validated_data):
    instance.name = validated_data.get('name', instance.name)
    instance.email = validated_data.get('email', instance.email)
    instance.save()
    return instance

常用属性

  1. data

    • 描述: 返回序列化后的数据。

    • 用途: 用于获取序列化后的数据。

    • 示例 :

      python 复制代码 
      serializer = MySerializer(instance)
serialized_data = serializer.data

  2. errors

    • 描述: 返回验证错误信息。

    • 用途: 用于获取验证错误信息。

    • 示例 :

      python 复制代码 
      serializer = MySerializer(data=request.data)
if not serializer.is_valid():
    errors = serializer.errors

  3. is_valid(raise_exception=False)

    • 描述: 检查数据是否有效。

    • 用途: 用于验证数据。

    • 示例 :

      python 复制代码 
      serializer = MySerializer(data=request.data)
if serializer.is_valid():
    # Data is valid
else:
    # Data is not valid

  4. validated_data

    • 描述: 返回验证后的数据。

    • 用途: 用于获取验证后的数据。

    • 示例 :

      python 复制代码 
      serializer = MySerializer(data=request.data)
if serializer.is_valid():
    validated_data = serializer.validated_data

  5. initial_data

    • 描述: 返回初始化时传入的原始数据。

    • 用途: 用于获取初始化时传入的原始数据。

    • 示例 :

      python 复制代码 
      serializer = MySerializer(data=request.data)
initial_data = serializer.initial_data

下面通过一个具体的示例来展示如何在实际应用中使用 BaseSerializer 中的常用方法。假设有一个简单的 Django 模型 Book，我们将创建一个序列化器 BookSerializer 来演示这些方法的实际用法。

模型定义

首先定义一个简单的 Book 模型：

python 复制代码 
from django.db import models

class Book(models.Model):
    title = models.CharField(max_length=100)
    author = models.CharField(max_length=100)
    published_date = models.DateField()
    isbn = models.CharField(max_length=13, unique=True)

序列化器定义

接下来定义一个 BookSerializer，并在其中使用 BaseSerializer 的常用方法：

python 复制代码 
from rest_framework import serializers
from .models import Book

class BookSerializer(serializers.Serializer):
    title = serializers.CharField(max_length=100)
    author = serializers.CharField(max_length=100)
    published_date = serializers.DateField()
    isbn = serializers.CharField(max_length=13)

    def to_representation(self, instance):
        """将模型实例转换为原生 Python 数据类型"""
        return {
            'title': instance.title,
            'author': instance.author,
            'published_date': instance.published_date,
            'isbn': instance.isbn,
        }

    def to_internal_value(self, data):
        """将原生数据转换为验证后的数据"""
        return {
            'title': data.get('title'),
            'author': data.get('author'),
            'published_date': data.get('published_date'),
            'isbn': data.get('isbn'),
        }

    def validate(self, attrs):
        """对输入数据进行验证"""
        if len(attrs['isbn']) != 13:
            raise serializers.ValidationError("ISBN must be 13 characters long.")
        return attrs

    def create(self, validated_data):
        """使用验证后的数据创建并返回一个新实例"""
        return Book.objects.create(**validated_data)

    def update(self, instance, validated_data):
        """使用验证后的数据更新并返回一个现有实例"""
        instance.title = validated_data.get('title', instance.title)
        instance.author = validated_data.get('author', instance.author)
        instance.published_date = validated_data.get('published_date', instance.published_date)
        instance.isbn = validated_data.get('isbn', instance.isbn)
        instance.save()
        return instance

例子1

序列化数据

将 Book 模型实例序列化为 JSON 格式：

python 复制代码 
from .models import Book
from .serializers import BookSerializer

# 假设我们有一个 Book 实例
book_instance = Book.objects.get(id=1)

# 序列化
serializer = BookSerializer(book_instance)
serialized_data = serializer.data
print(serialized_data)
反序列化数据

将 JSON 数据反序列化为 Book 模型实例：

python 复制代码 
from .serializers import BookSerializer

# 假设我们有一些 JSON 数据
json_data = {
    'title': 'New Book',
    'author': 'John Doe',
    'published_date': '2023-10-01',
    'isbn': '1234567890123'
}

# 反序列化
serializer = BookSerializer(data=json_data)
if serializer.is_valid():
    book_instance = serializer.save()
    print(book_instance)
else:
    print(serializer.errors)
更新实例

使用验证后的数据更新现有的 Book 实例：

python 复制代码 
from .models import Book
from .serializers import BookSerializer

# 假设我们有一个 Book 实例
book_instance = Book.objects.get(id=1)

# 新的数据
update_data = {
    'title': 'Updated Book',
    'author': 'Jane Doe',
    'published_date': '2023-10-02',
    'isbn': '1234567890123'
}

# 更新
serializer = BookSerializer(book_instance, data=update_data)
if serializer.is_valid():
    updated_instance = serializer.save()
    print(updated_instance)
else:
    print(serializer.errors)
验证数据

验证输入数据：

python 复制代码 
from .serializers import BookSerializer

# 一些无效的 JSON 数据
invalid_data = {
    'title': 'Invalid Book',
    'author': 'John Doe',
    'published_date': '2023-10-01',
    'isbn': '1234567890'  # ISBN 长度不正确
}

# 验证
serializer = BookSerializer(data=invalid_data)
if not serializer.is_valid():
    print(serializer.errors)  # 输出验证错误信息

例子2

好的，下面我将完善这个例子，假设有一个名为 StatPlatProjectData 的模型，并且我们希望在序列化时删除某些字段（如 created_at、updated_at 和 executor），将使用 BasicSerializer 作为基类，并在 to_representation 方法中自定义序列化逻辑。

模型定义

首先定义 StatPlatProjectData 模型：

python 复制代码 
from django.db import models

class StatPlatProjectData(models.Model):
    name = models.CharField(max_length=100)
    description = models.TextField()
    executor = models.CharField(max_length=100)
    created_at = models.DateTimeField(auto_now_add=True)
    updated_at = models.DateTimeField(auto_now=True)
序列化器定义

接下来定义 StatPlatProjectDataSerializer，并在其中使用 BasicSerializer 的常用方法：

python 复制代码 
from rest_framework import serializers
from .models import StatPlatProjectData

class BasicSerializer(serializers.ModelSerializer):
    pass

class StatPlatProjectDataSerializer(BasicSerializer):
    created_at = serializers.DateTimeField(format='%Y-%m-%d %H:%M:%S', read_only=True)
    updated_at = serializers.DateTimeField(format='%Y-%m-%d %H:%M:%S', read_only=True)

    class Meta:
        model = StatPlatProjectData
        fields = '__all__'

    def to_representation(self, instance):
        data = super().to_representation(instance)
        del_keys = ['created_at', 'updated_at', 'executor']
        for key in del_keys:
            data.pop(key, None)
        return data
序列化数据

将 StatPlatProjectData 模型实例序列化为 JSON 格式，并删除指定的字段：

python 复制代码 
from .models import StatPlatProjectData
from .serializers import StatPlatProjectDataSerializer

# 假设有一个 StatPlatProjectData 实例
project_data_instance = StatPlatProjectData.objects.get(id=1)

# 序列化
serializer = StatPlatProjectDataSerializer(project_data_instance)
serialized_data = serializer.data
print(serialized_data)

在这个例子中，serialized_data 将包含所有字段，除了 created_at、updated_at 和 executor。

反序列化数据

将 JSON 数据反序列化为 StatPlatProjectData 模型实例：

python 复制代码 
from .serializers import StatPlatProjectDataSerializer

# 假设有一些 JSON 数据
json_data = {
    'name': 'New Project',
    'description': 'This is a new project.',
    'executor': 'John Doe'
}

# 反序列化
serializer = StatPlatProjectDataSerializer(data=json_data)
if serializer.is_valid():
    project_data_instance = serializer.save()
    print(project_data_instance)
else:
    print(serializer.errors)
更新实例

使用验证后的数据更新现有的 StatPlatProjectData 实例：

python 复制代码 
from .models import StatPlatProjectData
from .serializers import StatPlatProjectDataSerializer

# 假设有一个 StatPlatProjectData 实例
project_data_instance = StatPlatProjectData.objects.get(id=1)

# 新的数据
update_data = {
    'name': 'Updated Project',
    'description': 'This is an updated project.',
    'executor': 'Jane Doe'
}

# 更新
serializer = StatPlatProjectDataSerializer(project_data_instance, data=update_data)
if serializer.is_valid():
    updated_instance = serializer.save()
    print(updated_instance)
else:
    print(serializer.errors)
验证数据

验证输入数据：

python 复制代码 
from .serializers import StatPlatProjectDataSerializer

# 一些无效的 JSON 数据
invalid_data = {
    'name': 'Invalid Project',
    'description': 'This is an invalid project.',
    'executor': ''  # executor 不能为空
}

# 验证
serializer = StatPlatProjectDataSerializer(data=invalid_data)
if not serializer.is_valid():
    print(serializer.errors)  # 输出验证错误信息
相关推荐
Amo Xiang18 分钟前
2024 Python3.10 系统入门+进阶（十五）：文件及目录操作
开发语言·python
liangbm328 分钟前
数学建模笔记——动态规划
笔记·python·算法·数学建模·动态规划·背包问题·优化问题
B站计算机毕业设计超人39 分钟前
计算机毕业设计Python+Flask微博情感分析 微博舆情预测 微博爬虫 微博大数据 舆情分析系统 大数据毕业设计 NLP文本分类 机器学习 深度学习 AI
爬虫·python·深度学习·算法·机器学习·自然语言处理·数据可视化
羊小猪~~43 分钟前
深度学习基础案例5--VGG16人脸识别(体验学习的痛苦与乐趣)
人工智能·python·深度学习·学习·算法·机器学习·cnn
waterHBO3 小时前
python 爬虫 selenium 笔记
爬虫·python·selenium
编程零零七4 小时前
Python数据分析工具(三)：pymssql的用法
开发语言·前端·数据库·python·oracle·数据分析·pymssql
AIAdvocate6 小时前
Pandas_数据结构详解
数据结构·python·pandas
小言从不摸鱼6 小时前
【AI大模型】ChatGPT模型原理介绍（下）
人工智能·python·深度学习·机器学习·自然语言处理·chatgpt
FreakStudio8 小时前
全网最适合入门的面向对象编程教程：50 Python函数方法与接口-接口和抽象基类
python·嵌入式·面向对象·电子diy
redcocal9 小时前
地平线秋招
python·嵌入式硬件·算法·fpga开发·求职招聘
热门推荐
01RAG 实践- Ollama+RagFlow 部署本地知识库02组基轨迹建模 GBTM的介绍与实现（Stata 或 R）032024年高教社杯数学建模国赛C题超详细解题思路分析04Coze扣子平台完整体验和实践（附国内和国际版对比）05苍穹外卖面试总结06【2024数模国赛赛题思路公开】国赛B题思路丨附可运行代码丨无偿自提07yolov8实战第五天——yolov8+ffmpg实时视频流检测并进行实时推流——（推流，保姆教学）08CCF-CSP认证考试 202406-3 文本分词 100分题解09【2024高教社杯全国大学生数学建模竞赛】B题 生产过程中的决策问题——解题思路 代码 论文10浏览器插件——ModHeader 的分享和学习