### Django REST framework Serializer 中 `source` 参数的作用和用法 在 Django REST framework 中，`source` 参数用于指定序列化器字段从模型或数据结构中获取值的来源。它允许开发者将序列化器字段与模型字段、方法或其他属性进行映射[^5]。 当定义一个序列化器字段时，如果没有显式指定 `source` 参数，则默认情况下，字段名称会直接映射到模型中的同名字段。如果需要从模型中不同的字段或方法获取值，可以通过 `source` 参数来指定来源。例如： ```python from rest_framework import serializers from .models import Article class ArticleSerializer(serializers.ModelSerializer): title = serializers.CharField(source='title_field') # 假设模型中有名为 title_field 的字段 author_name = serializers.CharField(source='author.name') # 获取关联对象的属性 custom_field = serializers.CharField(source='get_custom_value') # 调用模型中的方法 class Meta: model = Article fields = ['title', 'author_name', 'custom_field'] ``` #### `source` 参数的具体用法 1. **映射到模型字段**： 如果模型字段名称与序列化器字段名称不同，可以使用 `source` 参数指定模型字段名称。例如，模型中有 `btitle` 字段，但希望序列化器字段名称为 `title`[^1]。 ```python btitle = serializers.CharField(label='名称', source='btitle') ``` 2. **访问嵌套属性**： 可以通过点号（`.`）访问嵌套对象的属性。例如，如果模型中有一个外键关系 `author`，可以通过 `author.name` 访问作者的名字[^2]。 ```python author_name = serializers.CharField(source='author.name') ``` 3. **调用模型方法**： 如果模型中定义了某些方法，可以通过 `source` 参数调用这些方法。例如，模型中定义了一个方法 `get_custom_value`，可以通过以下方式调用。 ```python custom_field = serializers.CharField(source='get_custom_value') ``` 4. **处理复杂逻辑**： 在某些情况下，可能需要对多个字段进行组合或处理复杂的逻辑。此时可以结合 `source` 参数和自定义方法实现[^3]。 ```python combined_field = serializers.CharField(source='get_combined_value') def get_combined_value(self, obj): return f"{obj.title} - {obj.body[:50]}" ``` #### 示例代码 以下是一个完整的示例，展示如何使用 `source` 参数： ```python from rest_framework import serializers from .models import Article class ArticleSerializer(serializers.ModelSerializer): title_display = serializers.CharField(source='title', read_only=True) # 映射到模型字段 author_full_name = serializers.CharField(source='author.get_full_name') # 调用模型方法 short_body = serializers.CharField(source='get_short_body') # 自定义方法 class Meta: model = Article fields = ['id', 'title_display', 'author_full_name', 'short_body'] def get_short_body(self, obj): return obj.body[:50] + "..." if len(obj.body) > 50 else obj.body ``` ### 注意事项 - 如果 `source` 参数指向的方法或字段不存在，将会抛出异常。 - 使用 `source='*'` 可以将整个对象传递给字段，通常用于嵌套序列化器[^5]。 - 在 `ModelSerializer` 中，`source` 参数可以避免字段名称冲突，同时提高代码可读性[^4]。