Django RestFul framework Serializer序列化器的使用（定義）

Serializer 序列化器是DRF框架中重要的組成部分，可以快速根據 Django ORM 或者其它庫自動序列化/反序列化；

Serializer 作用：

　　1. 進行數據的校驗

　　2. 對數據對象進行轉換

代碼中使用的模型類：

1. 書籍模型類：

from django.db import models

#定義圖書模型類BookInfo
class BookInfo(models.Model):
    btitle = models.CharField(max_length=20, verbose_name='名稱')
    bpub_date = models.DateField(verbose_name='發佈日期')
    bread = models.IntegerField(default=0, verbose_name='閱讀量')
    bcomment = models.IntegerField(default=0, verbose_name='評論量')
    is_delete = models.BooleanField(default=False, verbose_name='邏輯刪除')

    class Meta:
        db_table = 'tb_books'  # 指明資料庫表名
        verbose_name = '圖書'  # 在admin站點中顯示的名稱
        verbose_name_plural = verbose_name  # 顯示的複數名稱

    def __str__(self):
        """定義每個數據對象的顯示信息"""
        return self.btitle

2. 書中的英雄模型類：

#定義英雄模型類HeroInfo

class HeroInfo(models.Model):
    GENDER_CHOICES = (
        (0, 'male'),
        (1, 'female')
    )
    hname = models.CharField(max_length=20, verbose_name='名稱') 
    hgender = models.SmallIntegerField(choices=GENDER_CHOICES, default=0, verbose_name='性別')  
    hcomment = models.CharField(max_length=200, null=True, verbose_name='描述信息') 
    hbook = models.ForeignKey(BookInfo, on_delete=models.CASCADE, verbose_name='圖書')  # 外鍵
    is_delete = models.BooleanField(default=False, verbose_name='邏輯刪除')

    class Meta:
        db_table = 'tb_heros'
        verbose_name = '英雄'
        verbose_name_plural = verbose_name

    def __str__(self):
        return self.hname

說明： 書籍和英雄是一對多的關係

3. 定義序列化類

1）定義方法

　　Django rest ful framework 中的Serializer使用類來定義，須繼承自 reset_framework.serializer.Serializer.

class BookInfoSerializer(serializers.Serializer):
    """圖書數據序列化器"""
    id = serializers.IntegerField(label='ID', read_only=True)
    btitle = serializers.CharField(label='名稱', max_length=20)
    bpub_date = serializers.DateField(label='發佈日期', required=False)
    bread = serializers.IntegerField(label='閱讀量', required=False)
    bcomment = serializers.IntegerField(label='評論量', required=False)

註意： serializer不是只能為資料庫模型類定義，也可以為非資料庫模型類的數據定義。serializer是獨立玉資料庫之外的存在

2）欄位與選項

常用欄位類型：

選項參數：

通用參數：

4. 創建Serializer對象

定義好Serializer類後，就可以創建Serializer對象了。

Serializer的構造方法為：

Serializer(instance=None, data=empty, **kwarg)

說明：

1）用於序列化時，將模型類對象傳入instance參數

2）用於反序列化時，將要被反序列化的數據傳入data參數

3）除了instance和data參數外，在構造Serializer對象時，還可通過context參數額外添加數據，如

serializer = BookInfoSerialize(book, context={'request': request})

通過context參數附加的數據，可以通過Serializer對象的context屬性獲取