Django模型的字段选项

每一种字段类型都需要指定一些特定的参数。例如,CharField(及其子类)需要接收一个max_length参数,用以指定数据库存储VARCHAR数据时的字节数。

一些可选的参数是通用的,可以用于任何字段类型,下面具体介绍一些会经常用到的通用参数。

  1. null(类型:Field.null)

null的默认值为False,如果设置为True,则当该字段为空时,Django模型会将数据库中的该字段设置为NULL。

注意:避免在基于字符串的字段(如CharField和TextField)上使用null类型,Django模型在使用惯例上是使用空字符串而不是NULL。

  1. blank(类型:Field.blank)

blank的默认值为False,如果设置为True,则该字段允许为空。

blank类型与null类型是有区别的。blank类型主要用于表单验证,如果某个表单域设为"blank=True",则验证时会允许该域为空值;如果某个表单域设为"blank=False",则验证时该域是必须填写的。

  1. default(类型:Field.default)

表示字段的默认值。该字段值可以是一个值或者是一个可调用的对象,如果是一个可调用的对象,则每次实例化模型时都会调用该对象。

default类型的代码示例如下:

【代码3-4】

01  def contact_default():
02      return {"email": "email@example.com"}
03  
04  contact_info = JSONField(
05                  "ContactInfo",
06                  default=contact_default)

【代码分析】

在第01、02行代码中定义了一个contact_default()方法,返回了一个email对象。

在第04~06行代码中定义了一个JSON域变量contact_info,其default值引用了contact_default()方法返回的email对象。

  1. choices(类型:Field.choices)

choices是一个用来选择值的二维元组。其中,第一个值是实际存储的值,第二个值用来进行选择。

choices类型最好是在Django模型中使用。下面是官方文档给出的代码示例,这个代码示例实现了一个大学生年级类。

【代码3-5】

01  from django.db import models
02  
03  class CollegeStudent(models.Model):
04      FRESHMAN = 'FR'
05      SOPHOMORE = 'SO'
06      JUNIOR = 'JR'
07      SENIOR = 'SR'
08      YEAR_IN_COLLEGE_CHOICES = [
09          (FRESHMAN, 'Freshman'),
10          (SOPHOMORE, 'Sophomore'),
11          (JUNIOR, 'Junior'),
12          (SENIOR, 'Senior'),
13      ]
14      year_in_college = models.CharField(
15          max_length=2,
16          choices=YEAR_IN_COLLEGE_CHOICES,
17          default=FRESHMAN,
18      )
19  
20      def is_upperclass(self):
21          return self.year_in_college in (self.JUNIOR, self.SENIOR)

【代码分析】

在第03行代码中定义了一个大学生类CollegeStudent。

在第04~07行代码中定义了一组字符串变量,即FRESHMAN、SOPHOMORE、JUNIOR和SENIOR,分别用于表示大学生四个年级的名称。

在第08~13行代码中定义了一个choices类型的变量YEAR_IN_COLLEGE_CHOICES,其中包含了4个元组,使用了第04~07行代码中定义的变量。

在第14~18行代码中定义了一个字符型域变量year_in_college,将choices值定义为变量YEAR_IN_COLLEGE_CHOICES,默认值为FRESHMAN。

在第20~21行代码中定义了一个方法is_upperclass(),用于返回大学生中的高年级元组。

  1. unique(类型:Field.unique)

如果unique的值设置为True,则这个字段必须在整个表中保持值唯一。unique类型还定义了一组关于日期和时间的子类型,例如unique_for_date(唯一日期)、unique_for_month(唯一月份)、unique_for_year(唯一年份)。

  1. editable(类型:Field.editable)

editable默认值为True(真),如果值为False(假),则在Admin模式下字段将不能编辑。

  1. primary_key(类型:Field.primary_key)

primary_key用于设置主键,一个字段只能设置一个主键。如果没有设置主键,则Django框架在创建表时会自动加上。如果primary_key值设置为True,则将该字段设置为该模型的主键,示例 如下:

id = meta.AutoField('ID', primary_key=True)

  1. help_text(类型:Field.help_text)

help_text是额外的"帮助"文本,随表单控件一同显示。示例如下:

help_text="Please use the following format: <em>YYYY-MM-DD</em>."

即便某个字段未用于表单,该类型对于生成文档也是很有用的。

  1. verbose_name(类型:Field.verbose_name)

verbose_name用于设置admin模式中字段的显示名称。

  1. validators(类型:Field.validators)

validators用于设置某个域的有效性检查列表。

  1. db_column(类型:Field.db_column)

db_column用于为某个域指定数据库列表的名称;如果未指定,则使用该域的名称。

  1. db_index(类型:Field.db_index)

如果db_index值为True,则创建数据库索引。

  1. db_tablespace(类型:Field.db_tablespace)

db_tablespace用于为某个域的索引指定数据库表空间的名称。

本文节选自《Django 5企业级Web应用开发实战(视频教学版)》,获出版社和作者授权发布。

相关推荐
日里安17 分钟前
8. 基于 Redis 实现限流
数据库·redis·缓存
EasyCVR41 分钟前
ISUP协议视频平台EasyCVR视频设备轨迹回放平台智慧农业视频远程监控管理方案
服务器·网络·数据库·音视频
Elastic 中国社区官方博客1 小时前
使用真实 Elasticsearch 进行更快的集成测试
大数据·运维·服务器·数据库·elasticsearch·搜索引擎·集成测试
Amo Xiang2 小时前
Django 2024全栈开发指南(一):框架简介、环境搭建与项目结构
python·django
明月与玄武2 小时前
关于性能测试:数据库的 SQL 性能优化实战
数据库·sql·性能优化
Amo Xiang2 小时前
Django 2024全栈开发指南(二):Django项目配置详解
python·django
PGCCC3 小时前
【PGCCC】Postgresql 存储设计
数据库·postgresql
PcVue China5 小时前
PcVue + SQL Grid : 释放数据的无限潜力
大数据·服务器·数据库·sql·科技·安全·oracle
魔道不误砍柴功7 小时前
简单叙述 Spring Boot 启动过程
java·数据库·spring boot
锐策7 小时前
〔 MySQL 〕数据库基础
数据库·mysql