当前位置： 首页 > news >正文

Django模型开发：模型字段、元数据与继承全方位讲解

news 2025/7/29 12:44:37

一、模型字段类型详解

在 Django 开发中，模型（Model）是连接应用程序与数据库的核心桥梁。

Django 与 MySQL 字段类型映射

Django 模型的每个字段都是特定 Field 类的实例，它决定了数据库存储类型和表单验证规则。

Django 字段类型 MySQL 数据类型 说明
CharField VARCHAR 字符串类型，需指定 max_length
TextField TEXT 长文本类型
IntegerField INT 整数类型
BigIntegerField BIGINT 长整数类型
BooleanField TINYINT(1) 布尔类型（0=False，1=True）
DateTimeField DATETIME 日期时间类型
SmallIntegerField SMALLINT 小整数类型

整数类型深度对比

TINYINT和SMALLINT是两种常用的整数类型，选择合适的类型能优化存储效率

维度 TINYINT SMALLINT
存储空间 1 字节（8 位） 2 字节（16 位）
有符号范围 -128 到 127 -32768 到 32767
无符号范围 0 到 255 0 到 65535
适用场景 布尔值、状态标记、年龄、枚举值等小范围数值 用户积分、订单数量等中等范围数值
示例 年龄（0-120）、月份（1-12）、星期（1-7） 用户积分（0-5000）、订单数量（0-30000）

二、常用字段选项

字段选项用于配置字段的行为特性，以下是开发中最常用的选项

null 与 blank 的区别

# null影响数据库存储，blank影响表单验证
field1 = models.CharField(max_length=100, null=True)  # 数据库可存NULL
field2 = models.CharField(max_length=100, blank=True)  # 表单可提交空值
field3 = models.CharField(max_length=100, null=True, blank=True)  # 两者皆可
  • null=True：允许数据库存储 NULL 值（默认 False）
  • blank=True：允许表单提交空值（默认 False）
  • 注意：前端提交""空字符串时，若blank=False会触发验证错误

注释与帮助文本

class Book(models.Model):title = models.CharField(max_length=100,help_text='Enter the book title',  # 表单帮助文本db_comment="图书标题"  # 数据库字段注释（Django4.2+）)class Meta:db_table_comment = 'This table stores information about books.'  # 数据库表注释
  • help_text：表单帮助文本
  • db_comment： 数据库字段注释

默认值设置

# 固定默认值
count = models.IntegerField(default=0)# 可调用对象作为默认值
from datetime import date
birth_date = models.DateField(default=date.today)
  • default ： 该字段的默认值

日期时间特殊选项

class BaseModel(models.Model):# 首次创建时自动设置当前时间created_at = models.DateTimeField(auto_now_add=True)# 每次save()时自动更新为当前时间updated_at = models.DateTimeField(auto_now=True)

注意：

  • auto_now在QuerySet.update()时不会自动生效，需手动更新或使用save()
  • auto_now_add、auto_now 和 default 选项相互排斥，这些选项的任何组合都会导致报错
class Article(models.Model):def save(self, *args, **kwargs):if not self.pk:  # 仅在首次创建时设置self.created_at = timezone.now()self.updated_at = timezone.now()super().save(*args, **kwargs)
  • 当需要复杂时间逻辑时，覆盖模型的 save() 方法

选项列表（choices）

使用choices定义字段的可选值范围

# 直接定义选项
class Person(models.Model):SHIRT_SIZES = [("S", "Small"),("M", "Medium"),("L", "Large"),]shirt_size = models.CharField(max_length=1, choices=SHIRT_SIZES)# 枚举类定义选项（推荐）
from enum import Enum
class UserTypeEnum(Enum):MEMBER = 1  # 会员ADMIN = 2   # 管理员class User(models.Model):user_type = models.SmallIntegerField(choices=[(item.value, item.name) for item in UserTypeEnum],default=UserTypeEnum.MEMBER.value)

三、模型元数据与方法

模型 Meta 类

通过内部Meta类定义模型的元数据，即 "非字段信息"

class User(models.Model):username = models.CharField(max_length=50)email = models.EmailField()class Meta:db_table = "system_users"  # 数据库表名db_table_comment = "用户信息表"  # 数据库表注释ordering = ['-id']  # 默认排序verbose_name = "用户"  # 单数显示名verbose_name_plural = "用户"  # 复数显示名

managed=False适用于：

  • 与遗留数据库集成时
  • 不希望 Django 自动修改表结构的场景

模型管理器（Manager）

Manager 是模型与数据库交互的接口，默认名为objects。 模型管理器只能通过模型类来访问，一般用于“表级”操作

# 表级操作
all_users = User.objects.all()
active_users = User.objects.filter(is_active=True)
user = User.objects.get(id=1)

自定义模型方法

模型方法用于实现 "行级" 操作，可自定义业务逻辑

  • 重写 save() 方法：例如实现保存前后的处理
  • 重写 delete() 方法：例如实现软删除
  • 其它自定义方法：例如编写原生 SQL 语句
class Blog(models.Model):name = models.CharField(max_length=100)tagline = models.TextField()def save(self, *args, **kwargs):# 保存前处理self.name = self.name.title()super().save(*args, **kwargs)  # 调用父类方法# 保存后操作self.clear_cache()def clear_cache(self):"""自定义缓存清理方法"""cache.delete(f"blog_{self.id}")

注意：重写的模型方法不会在批量操作（例如update()）中调用

四、模型继承

抽象基类

将公共字段提取到抽象基类，避免代码重复

class CommonInfo(models.Model):"""抽象基类：包含公共字段"""name = models.CharField(max_length=100)age = models.PositiveIntegerField()created_at = models.DateTimeField(auto_now_add=True)class Meta:abstract = True  # 标记为抽象类，不生成数据表# 继承抽象基类
class Student(CommonInfo):home_group = models.CharField(max_length=5)# 自动拥有name, age, created_at字段class Teacher(CommonInfo):department = models.CharField(max_length=50)# 自动拥有name, age, created_at字段

模型继承实战

实战场景：在一个Django+Vue 后台管理系统中，需要维护多个数据表。这些数据表中，一般需要记录创建者、创建时间、更新者和更新时间等信息。可将该部分公共字段提取到抽象基类，避免代码重复。

定义抽象基类BaseModel

from django.db import modelsclass BaseModel(models.Model):creator = models.CharField(max_length=64, blank=True, null=True, default="", db_comment="创建者")create_time = models.DateTimeField(auto_now_add=True, db_comment="创建时间")updater = models.CharField(max_length=64, blank=True, null=True, default="", db_comment="更新者")update_time = models.DateTimeField(auto_now=True, db_comment="更新时间")class Meta:abstract = True

继承抽象基类：点击查看完整代码

image-20250729094647649

实现效果

image-20250729094846231

您正在阅读的是《Django从入门到实战》专栏！关注不迷路~

http://www.sczhlp.com/news/330.html

相关文章：

  • 矿山领航者：向明智控如何通过CRM实现数字化升级
  • BeanFactory和FactoryBean的区别
  • DevOps工具进化论：2025年国内开发者如何选择最佳技术栈
  • E. Split Into Two Sets
  • 2025.7.28学习日记
  • BSC 验证者获取接口的时间差问题分析 - 若
  • 教师资格证考试笔试报名流程
  • linux RabbitMq 消息队列
  • TheHackersLabs Torrijas writeup
  • 蔚来汽车携手通义灵码入选 2025 世界人工智能大会标杆案例
  • CRMEB会员电商系统高可用集群部署实战：阿里云COS静态资源分离方案详解
  • 麦当劳 - 1
  • 一个简单的文字特效
  • openGauss关于日期的计算注意事项
  • 一文带你全面了解教师资格证
  • 小飞标签
  • P6246 邮局题解
  • [lnsyoj2085] 底垫
  • 病从口入，祸从口出
  • 7.28
  • 基于 PyTorch 的端到端验证码识别系统设计与实现
  • Linux安装 MYSQL
  • Groovy注入
  • P1545 Dividing the Path G（线段树+动态规划）
  • .NET4通过HTTP操作MINIO
  • Gitee：重塑中国企业级研发基础设施的三大战略支点
  • SAP生产订单报工的“最终确认”、“结清未清预留”，你真弄清楚了吗?
  • 基于图像处理与SVM的验证码识别系统实现
  • 基于因子图与和积算法的MATLAB实现
  • 【文献阅读】AnyEdit：编辑语言模型中编码的任何知识