序列化器的字段处理不仅会验证值(validate),也会将接收值转化为相应类型(clean)
1 核心参数
1. read_only
只应该包含在输出中,任何输入字段(创建和更新)中包含该属性都会被忽略,默认为False
2. write_only
只会在update/create时使用,外界也无法读取该值,默认为False
3. required
正常情况下在反序列化时字段没有提供值,将会报错,设置为False,就可以为空,默认为True
4. allow_null
验证数据时允许为空,默认为False,不允许
5. default
如果没有提供时,就返回默认值。可以将其设置为一个函数或其他可调用的函数,在这种情况下,每次使用该值时都将对其进行评估。当被调用时,它将不会收到任何参数。如果可调用对象有一个set_context方法,那么每次调用字段实例的值作为参数时都将调用该方法。这与验证器的工作方式相同。
同时包含default 和 required参数的将会报错
6. source
用于填充该字段,可以是一个方法,只接受一个self参数,如URLField(source=’get_absolute_url’),也可以通过‘.’快捷方式调用对象属性,如EmailField(source=’user.email’)
source=’*’有着特殊的意义,表示将整个对象都会传递进去,在创建嵌套结构和或者需要完整对象来确定输出的时候特别有用。默认为字段名。
7. validators
用于验证字段值的函数列表,失败抛出serializers.ValidationError
8. error_messages
表示错误代码的错误信息
9. label
可以作为HTML表单字段中的name使用,或者其他描述性文本
10. help_text
用于在HTML表单中描述该字段
11. initial
用于预填充HTML表单字段,可以是一个可调用对象,如
import datetime
from rest_framework import serializers
class ExampleSerializer(serializers.Serializer):
day = serializers.DateField(initial=datetime.date.today)
12. style
用于控制render怎么渲染的字典参数
# Use <input