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},
        }