Django序列化中`SerializerMethodField`有哪些局限性

SerializerMethodField的基本概念

• 定义：SerializerMethodField是Django REST framework提供的一个特殊字段类型。它允许你定义一个方法来动态地获取和返回序列化数据中的某个字段值，这个方法可以根据模型实例的其他属性、关联模型或任何自定义的逻辑来生成返回值。
• 用途：当你需要在序列化数据中包含一些不能直接从模型字段获取的信息，或者需要对模型字段进行特殊处理（如格式化日期、拼接字符串等）后再返回时，SerializerMethodField就非常有用。例如，计算模型实例中的两个字段的和、获取关联模型的某个属性组合等。

使用SerializerMethodField的步骤

• 步骤一：在序列化器中定义SerializerMethodField
  • 假设你有一个Product模型，包含price和tax两个字段，你想在序列化数据中包含一个total_price字段，这个字段的值是price加上tax的值。首先，在serializers.py文件中定义序列化器：

  from rest_framework import serializers
  from.models import Product
  
  class ProductSerializer(serializers.ModelSerializer):
      total_price = serializers.SerializerMethodField()
  
      class Meta:
          model = Product
          fields = ['price', 'tax', 'total_price']
  

  • 这里total_price被定义为SerializerMethodField，它告诉序列化器这个字段的值需要通过一个自定义的方法来获取。
• 步骤二：定义获取字段值的方法
  • 在ProductSerializer类中，需要定义一个方法来获取total_price字段的值。这个方法的命名规则是get_<field_name>，其中<field_name>是SerializerMethodField定义的字段名。在这个例子中，方法名为get_total_price：

  class ProductSerializer(serializers.ModelSerializer):
      total_price = serializers.SerializerCountryMethodField()
  
      def get_total_price(self, product):
          return product.price + product.tax
  
      class Meta:
          model = Product
          fields = ['price', 'tax', 'total_price']
  

  • 这个get_total_price方法接收一个product对象（即当前正在被序列化的Product模型实例）作为参数，然后返回price和tax字段值的和。这个返回值将作为total_price字段在序列化数据中的值。
• 步骤三：在视图中使用序列化器
  • 在视图函数或视图集中使用这个序列化器。例如，在一个基于类的视图集中：

  from rest_framework.viewsets import ModelViewSet
  from.serializers import ProductSerializer
  from.models import Product
  
  class ProductViewSet(ModelViewSet):
      queryset = Product.objects.all()
      serializer_class = ProductSerializer
  

  • 当这个视图集处理请求时，ProductSerializer会按照定义的方式对Product模型实例进行序列化。对于total_price字段，会调用get_total_price方法来获取值，并将其包含在序列化数据中。

SerializerMethodField在关联模型中的应用

• 处理一对多关联关系：假设你有Author和Book两个模型，一个Author可以有多本Book，并且你想在序列化Author时包含其所有书籍的标题列表。
  • 模型定义如下：

  from django.db import models
  
  class Author(models.Model):
      name = models.CharField(max_length=100)
  
  class Book(models.Model):
      title = models.CharField(max_length=200)
      author = models.ForeignKey(Author, on_delete=models.CASCADE)
  

  • 在serializers.py中定义序列化器：

  from rest_framework import serializers
  from.models import Author, Book
  
  class BookSerializer(serializers.ModelSerializer):
      class Meta:
          model = Book
          fields = ['title']
  
  class AuthorSerializer(serializers.ModelSerializer):
      book_titles = serializers.SerializerMethodField()
  
      def get_book_titles(self, author):
          books = author.book_set.all()
          return [book.title for book in books]
  
      class Meta:
          model = Author
          fields = ['name', 'book_titles']
  

  • 这里AuthorSerializer中的book_titles字段通过SerializerMethodField来获取当前Author关联的所有Book的标题列表。get_book_titles方法获取Author关联的所有Book实例，然后提取每个Book的title字段值，最后返回一个标题列表作为book_titles字段的值。
• 处理多对多关联关系（类似逻辑）：如果是多对多关联关系，比如Student和Course模型之间的选课关系，在序列化Student时想要包含所选课程的名称列表，也可以使用类似的方法。只是在获取关联模型数据时，需要注意多对多关系的处理方式（通常通过many - to - many属性来获取关联的模型集合）。