[[407827]]

本文轉(zhuǎn)載自微信公眾號「AirPython」，作者星安果。轉(zhuǎn)載本文請聯(lián)系A(chǔ)irPython公眾號。

1. 前言

大家好，我是安果!

接下來，將通過幾篇文章將對 DRF 模型序列化進行展開說明，詳情談?wù)勀Ｐ托蛄谢淖饔谩⒉襟E及進階用法

2. 模型序列化的作用?

作為 DRF 中非常關(guān)鍵的一步，模型序列化主要作用有 3 個

• 序列化數(shù)據(jù)

用于將模型序列化成 JSON 格式的對象，便于數(shù)據(jù)返回

• 表單驗證

在表單請求中，用于驗證用戶上傳的數(shù)據(jù)是否滿足項目要求

• 數(shù)據(jù)操作

可用于數(shù)據(jù)更新、數(shù)據(jù)創(chuàng)建、數(shù)據(jù)保存等

3. 表單字段驗證

指定需要序列化的字段時，可以設(shè)置字段類型、默認值、可讀或可寫、驗證錯誤提示信息等，然后針對表單字段進行驗證

表單字段驗證同樣有 3 種方式，分別對應(yīng)：

3-1 序列化字段，使用參數(shù)形式進行制定

比如，字段 name 數(shù)據(jù)類型為字符串，max_length 指定最大長度，必須輸入，并使用「 error_messages 」設(shè)置驗證失敗的提示信息

# 最大長度50 
# required=True：必須輸入 
# 如果不傳遞，則報錯：name必須要傳遞 
name = serializers.CharField(max_length=50, required=True, error_messages={"required": "name必須要傳遞"}) 

3-2 重寫 validate( self , attrs ) 方法進行驗證

參數(shù) attrs 包含所有字段

我們只需要自定義驗證邏輯，如果驗證不通過，拋出「 serializers.ValidationError 」異常即可

比如，這里驗證 name 中必須包含關(guān)鍵字「 深圳 」，否則拋出異常(代表驗證失敗)

def validate(self, attrs): 
    """ 
    表單數(shù)據(jù)驗證 
    :param attrs: 
    :return: 
    """ 
    print(attrs) 
    if "深圳" not in attrs.get("name"): 
        raise serializers.ValidationError('名稱中沒有包含【深圳】，驗證失敗！') 
    return attrs 

3-3 重寫 validate_字段名(self,value) 方法

單獨針對某個字段進行驗證

比如，我們還是對 name 字段進行驗證，如果驗證不通過，主動拋出「 serializers.ValidationError 」異常即可

def validate_name(self, name): 
    """ 
    對name字段進行驗證 
    :param name:  
    :return:  
    """ 
    if "深圳" not in name: 
        raise serializers.ValidationError('名稱中沒有包含【深圳】，驗證失敗！') 
    return name 

4. 重寫創(chuàng)建、更新方法

創(chuàng)建的序列化類繼承于 serializers.Serializer 類

這里重寫 update() 和 create() 函數(shù)

其中，

• update( self, instance, validated_data )

用于更新數(shù)據(jù)，將參數(shù) validated_data 中的數(shù)據(jù)更新到 instance 中

• create(self, validated_data)

validated_data 作為關(guān)鍵字參數(shù)，用于創(chuàng)建模型

class GoodsSerializer(serializers.Serializer): 
    # 需要序列化的字段 
    # 注意：自動生成的字段，只會涉及讀取的場景 
    id = serializers.IntegerField(read_only=True) 
 
    # error_messages：定義錯誤信息 
    name = serializers.CharField(max_length=200, required=True, error_messages={"required": "name參數(shù)必須要傳遞"}) 
 
    def update(self, instance, validated_data): 
        """ 
        更新數(shù)據(jù)，將validated_data中的數(shù)據(jù)更新到instance中 
        :param instance: 
        :param validated_data: 
        :return: 
        """ 
        # 修改數(shù)據(jù) 
        instance.name = validated_data.get("name", instance.name) 
 
        # 保存更新 
        instance.save() 
        return instance 
 
    def create(self, validated_data): 
        """ 
        創(chuàng)建數(shù)據(jù) 
        :param validated_data: 
        :return: 
        """ 
        # Goods：模型 
        return Goods.objects.create(**validated_data) 

5. 最后

本章講到模型普通序列化的步驟，關(guān)于模型序列化、序列化嵌套、項目實戰(zhàn)中流程，我將在下一篇文章進行說明。