Django序列化常用字段与参数

序列化常见字段

字段	含义	字段构造方式
BooleanField	布尔值判断(True/False)	BooleanField()
NullBooleanField	布尔值判断(可以为Null)	NullBooleanField()
CharField	文本字符串	CharField(max_length=None, min_length=None, allow_blank=False, trim_whitespace=True)
EmailField	邮箱格式	EmailField(max_length=None, min_length=None, allow_blank=False)
RegexField	符合特定正则的字符串	RegexField(regex, max_length=None, min_length=None, allow_blank=False)
SlugField	短标签(URL)	SlugField(maxlength=50, min_length=None, allow_blank=False) 正则字段，验证正则模式 [a-zA-Z0-9-]+
URLField	URL格式	URLField(max_length=200, min_length=None, allow_blank=False)
UUIDField	存储UUID(通用唯一标识)	UUIDField(format=’hex_verbose’) format: 1) `'hex_verbose'` 如`"5ce0e9a5-5ffa-654b-cee0-1238041fb31a"` 2） `'hex'` 如 `"5ce0e9a55ffa654bcee01238041fb31a"` 3）`'int'` - 如: `"123456789012312313134124512351145145114"` 4）`'urn'` 如: `"urn:uuid:5ce0e9a5-5ffa-654b-cee0-1238041fb31a"`
IPAddressField	IP地址(高版本Django已废弃)	IPAddressField(protocol=’both’, unpack_ipv4=False, **options)
IntegerField	整数类型	IntegerField(max_value=None, min_value=None)
FloatField	浮点数类型	FloatField(max_value=None, min_value=None)
DecimalField	精确的十进制数据	DecimalField(max_digits, decimal_places, coerce_to_string=None, max_value=None, min_value=None) max_digits: 最多位数 decimal_palces: 小数点位置
DateTimeField	日期时间	DateTimeField(format=api_settings.DATETIME_FORMAT, input_formats=None)
DateField	日期	DateField(format=api_settings.DATE_FORMAT, input_formats=None)
TimeField	时间	TimeField(format=api_settings.TIME_FORMAT, input_formats=None)
DurationField	时间段或持续时间	DurationField()
ChoiceField	存储预定选项中的一项	ChoiceField(choices) choices与Django的用法相同
MultipleChoiceField	存储预定选项中的多项	MultipleChoiceField(choices)
FileField	文件数据	FileField(max_length=None, allow_empty_file=False, use_url=UPLOADED_FILES_USE_URL)
ImageField	图片数据	ImageField(max_length=None, allow_empty_file=False, use_url=UPLOADED_FILES_USE_URL)
ListField	列表数据	ListField(child=, min_length=None, max_length=None)
DictField	字典数据	DictField(child=)

序列化常见参数

通用字段参数	参数	含义
	required	表示该字段在反序列化时必须添加，默认为True
	default	默认值
	allow_null	表名该字段是否允许传入None，默认为False
	validators	该字段使用的验证器，一般是自己定义的，类似于钩子函数
	error_messages	包含异常的编码和错误信息
	label	用于HTML展示API页面时，显示的字段名称
	help_text	用于HTML展示API页面时，显示的字段帮助提示信息
	read_only	表明该字段仅用于序列化输出，默认False
	write_only	表明该字段仅用于反序列化输入，默认False
CharField参数
	max_length	最大长度
	min_lenght	最小长度
	allow_blank	是否允许为空
	trim_whitespace	是否截断空白字段
IntegerField字段
	max_value	最大值
	min_value	最小值