DRF - ModelSerializer - 基礎 - 2.0

理解

ModelSerializer：模型類序列化器

優點：可以快速創建一個Serializer類

對比

ModelSerializer與常規的Serializer相同，但提供了：

• 基於模型類自動生成一系列字段
• 基於模型類自動爲Serializer生成validators，比如unique_together
• 包含默認的create()和update()的實現

定義

例子

class BookInfoSerializer(serializers.ModelSerializer):

    class Meta:
        model = BookInfo       # 指明參照哪個模型類

        fields = '__all__'    # 指明爲模型類的哪些字段，來生成序列化器字段，__all__表名包含所有字段，也可以寫明具體哪些字段
        fields = ('id','name', 'readcount', 'commentcount')

        exclude = ('image',)   # 可以明確排除掉哪些字段
        
        # 默認ModelSerializer使用主鍵作爲關聯字段，但是我們可以使用depth來簡單對生成嵌套表示，depth是整數，表明嵌套的層級數量，可去回頭看看， 2.0/序列化中“關聯對象 - 嵌套序列化”
        depth = 1 

        read_only_fields = ('id', 'readcount', 'commentcount')   # 指明只讀字段，即僅用於序列化輸出的字段（即，只給用戶看的，不能向我服務器寫入（修改）該字段內容）
        
        # extra_kwargs，添加額外參數
        extra_kwargs = {

            # 如，爲ModelSerializer，添加或修改原有的選項參數（修改約束）            
            'readcount': {'min_value': 0, 'required': True},
            'commentcount': {'max_value': 0, 'required': True},
        }