使用Django2.0构建Python Restful Web服务：十）创建模型序列化器

在上一小篇文章中，我们设计并创建和新的Django项目的模型，本篇我们继续《使用Django 2.0构建Python Restful Web服务》。今天我们来为模型创建序列化和反序列化器，对电影分类模型、电影模型、观众模型、和电影评分模型分别创建模型的序列化器。

在这里，我们的模型之间都是有相互的关联关系的，为了体现模型之间的关联性，我们在创建序列化器的时候也需要考虑到。

文章目录

一、使用超链接序列化器

在本系列教程的第五篇，我们曾经使用rest_framework的序列化类创建过一个简单的模型序列化器，而在本篇文章中，我们则使用更加高级的超链接模型序列化器——HyperlinkedModelSerializer()。超链接模型序列化器有什么特别之处呢，我们来看看rest_framwork源码中的介绍：

    """
    A type of `ModelSerializer` that uses hyperlinked relationships instead
    of primary key relationships. Specifically:
 
    * A 'url' field is included instead of the 'id' field.
    * Relationships to other instances are hyperlinks, instead of primary keys.
    """
 

简而言之就是通过超链接的形式来表示模型之间的关系，并通过url字段与其他模型进行连接。这样的概念似乎不是很清晰，下面我们通过实际的代码来演示一下。

在userscore目录下创建一个名为serializers.py的文件，我们的模型序列化器就在这里面进行定义

二、电影分类模型序列化器

电影分类模型的序列化器是我们定义的第一个序列化器，我们在serializers.py文件中写入以下代码：

# 电影分类序列化器
class MovieCategorySerializer(serializers.HyperlinkedModelSerializer):
    # 使用超链接关系字段
    movies = serializers.HyperlinkedRelatedField(
        many=True, # 表示序列化多个对象
        read_only=True,# 表示在序列化时使用，反序列化时不使用
        view_name = 'movie-detail' # 绑定对应的超链接视图函数名，默认情况下为:模型名称-detail
    )
 
    class Meta:
        model = MovieCategory # 序列化器对应的模型
        # 序列化器返回的字段
        fields = (
            'url',
            'pk',
            'name',
            'movies'
        )
 

在MovieCategorySerializer序列化器中，我们继承了超链接模型序列化器HyperlinkedModelSerializer，然后使用超链接关系字段HyperlinkedRelatedField来声明movies字段，同时使用many属性设置该序列化器序列化多个对象，使用read_only属性设置其用于只读状态，使用view_name属性确定超链接的视图函数。

三、电影序列化器

对于电影序列化器，我们依然继承自HyperlinkedModelSerializer()，同时在电影序列化器中使用序列化器的标签关系字段SlugRelatedField()来描述电影分类字段，最后，在Meta()中声明电影序列化器使用到的模型Movie和各个字段。电影序列化器MovieSerializer()的代码如下所示：

# 电影序列化器
class MovieSerializer(serializers.HyperlinkedModelSerializer):
    # 使用标签关系字段定义分类
    movie_category = serializers.SlugRelatedField(queryset=MovieCategory.objects.all(),slug_field='name')
 
    class Meta:
        model = Movie
        fields = (
            'url',
            'movie_category',
            'name',
            'release_date',
            'viewed',
        )
 

四、电影评分序列化器

在模型model中，我们的电影评分模型中有两个外键字段——观众字段和电影字段，这些外键字段需要我们在创建序列化器的时候进行另外的处理。在电影评分序列化器中，外键字段我们只设置电影的字段，观众字段我们将在观众序列化器中将电影评分序列化器包含进去。所以，电影评分序列化器的代码如下：

# 电影评分序列化器
class ScoreSerializer(serializers.ModelSerializer):
    movie = MovieSerializer()
 
    class Meta:
        model = MovieScore
        fields = (
            'url',
            'pk',
            'score',
            'score_date',
            'movie'
        )
 

五、观众序列化器

现在轮到了观众序列化器。在电影评分序列化器中，我们没有将观众字段添加进行，因为我们将在观众序列化器添加评分字段，而这在观众模型中是不存在的。所以观众序列化器的代码如下所示：

# 观众序列化器
class ViewerSerializer(serializers.HyperlinkedModelSerializer):
    scores = ScoreSerializer(many=True,read_only=True)
    gender = serializers.ChoiceField(choices=Viewer.GENDER_CHOICES)
    gender_description = serializers.CharField(source='get_gender_display',read_only=True)
 
    class Meta:
        model = Viewer
        fields = (
            'url',
            'name',
            'gender',
            'gender_description',
            'scores'
        )
 

六、观众评分序列化器

除了模型中对应的各个模型的序列化器，我们再创建一个综合的序列化器——观众评分序列化器，用于获得观众的电影评分。其代码如下所示：

# 观众评分序列化器
class ViewerScoreSerializer(serializers.ModelSerializer):
    Viewer = serializers.SlugRelatedField(queryset=Viewer.objects.all(), slug_field='name')
    movie = serializers.SlugRelatedField(queryset=Movie.objects.all(), slug_field='name')
 
    class Meta:
        model = MovieScore
        fields = (
            'url',
            'pk',
            'score',
            'score_date',
            'viewer',
            'movie'
        )
 

最后

这样，我们就创建完了Django项目所需的所有模型序列化器，下一步，我们将创建在视图函数中对数据进行反序列化。有疑问欢迎留言讨论。