django之模型类的创建

本文深入讲解了Django的ORM操作,包括模型类的定义、字段类型及选项、外键关联等核心概念,以及如何通过迁移将模型同步至数据库。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

定义模型类

  • 模型类被定义在"应用/models.py"文件中。
  • 模型类必须继承自Model类,位于包django.db.models中。

接下来首先以"图书-英雄"管理为例进行演示。

1 定义

创建应用booktest,在models.py 文件中定义模型类。

from django.db import models

#定义图书模型类BookInfo
class BookInfo(models.Model):
    btitle = models.CharField(max_length=20, verbose_name='名称')
    bpub_date = models.DateField(verbose_name='发布日期')
    bread = models.IntegerField(default=0, verbose_name='阅读量')
    bcomment = models.IntegerField(default=0, verbose_name='评论量')
    is_delete = models.BooleanField(default=False, verbose_name='逻辑删除')

    class Meta:
        db_table = 'tb_books'  # 指明数据库表名
        verbose_name = '图书'  # 在admin站点中显示的名称
        verbose_name_plural = verbose_name  # 显示的复数名称

    def __str__(self):
        """定义每个数据对象的显示信息"""
        return self.btitle

#定义英雄模型类HeroInfo
class HeroInfo(models.Model):
    GENDER_CHOICES = (
        (0, 'male'),
        (1, 'female')
    )
    hname = models.CharField(max_length=20, verbose_name='名称') 
    hgender = models.SmallIntegerField(choices=GENDER_CHOICES, default=0, verbose_name='性别')  
    hcomment = models.CharField(max_length=200, null=True, verbose_name='描述信息') 
    hbook = models.ForeignKey(BookInfo, on_delete=models.CASCADE, verbose_name='图书')  # 外键
    is_delete = models.BooleanField(default=False, verbose_name='逻辑删除')

    class Meta:
        db_table = 'tb_heros'
        verbose_name = '英雄'
        verbose_name_plural = verbose_name

    def __str__(self):
        return self.hname

1) 数据库表名

模型类如果未指明表名,Django默认以 小写app应用名_小写模型类名 为数据库表名。

可通过db_table 指明数据库表名。

2) 关于主键

django会为表创建自动增长的主键列,每个模型只能有一个主键列,如果使用选项设置某属性为主键列后django不会再创建自动增长的主键列。

默认创建的主键列属性为id,可以使用pk代替,pk全拼为primary key。

3) 属性命名限制

  • 不能是python的保留关键字。
  • 不允许使用连续的下划线,这是由django的查询方式决定的。
  • 定义属性时需要指定字段类型,通过字段类型的参数指定选项,语法如下:

    属性=models.字段类型(选项)
    

4)字段类型

类型说明
AutoField自动增长的IntegerField,通常不用指定,不指定时Django会自动创建属性名为id的自动增长属性
BooleanField布尔字段,值为True或False
NullBooleanField支持Null、True、False三种值
CharField字符串,参数max_length表示最大字符个数
TextField大文本字段,一般超过4000个字符时使用
IntegerField整数
DecimalField十进制浮点数, 参数max_digits表示总位数, 参数decimal_places表示小数位数
FloatField浮点数
DateField日期, 参数auto_now表示每次保存对象时,自动设置该字段为当前时间,用于"最后一次修改"的时间戳,它总是使用当前日期,默认为False; 参数auto_now_add表示当对象第一次被创建时自动设置当前时间,用于创建的时间戳,它总是使用当前日期,默认为False; 参数auto_now_add和auto_now是相互排斥的,组合将会发生错误
TimeField时间,参数同DateField
DateTimeField日期时间,参数同DateField
FileField上传文件字段
ImageField继承于FileField,对上传的内容进行校验,确保是有效的图片

5) 选项

选项说明
null如果为True,表示允许为空,默认值是False
blank如果为True,则该字段允许为空白,默认值是False
db_column字段的名称,如果未指定,则使用属性的名称
db_index若值为True, 则在表中会为此字段创建索引,默认值是False
default默认
primary_key若为True,则该字段会成为模型的主键字段,默认值是False,一般作为AutoField的选项使用
unique如果为True, 这个字段在表中必须有唯一值,默认值是False

null是数据库范畴的概念,blank是表单验证范畴的

6) 外键

在设置外键时,需要通过on_delete选项指明主表删除数据时,对于外键引用表数据如何处理,在django.db.models中包含了可选常量:

  • CASCADE 级联,删除主表数据时连通一起删除外键表中数据

  • PROTECT 保护,通过抛出ProtectedError异常,来阻止删除主表中被外键应用的数据

  • SET_NULL 设置为NULL,仅在该字段null=True允许为null时可用

  • SET_DEFAULT 设置为默认值,仅在该字段设置了默认值时可用

  • SET() 设置为特定值或者调用特定方法,如

    from django.conf import settings
    from django.contrib.auth import get_user_model
    from django.db import models
    
    def get_sentinel_user():
        return get_user_model().objects.get_or_create(username='deleted')[0]
    
    class MyModel(models.Model):
        user = models.ForeignKey(
            settings.AUTH_USER_MODEL,
            on_delete=models.SET(get_sentinel_user),
        )
    
  • DO_NOTHING 不做任何操作,如果数据库前置指明级联性,此选项会抛出IntegrityError异常

2 迁移

将模型类同步到数据库中。

1)生成迁移文件

python manage.py makemigrations

2)同步到数据库中

python manage.py migrate

3 添加测试数据

insert into tb_books(btitle,bpub_date,bread,bcomment,is_delete) values
('射雕英雄传','1980-5-1',12,34,0),
('天龙八部','1986-7-24',36,40,0),
('笑傲江湖','1995-12-24',20,80,0),
('雪山飞狐','1987-11-11',58,24,0);
insert into tb_heros(hname,hgender,hbook_id,hcomment,is_delete) values
('郭靖',1,1,'降龙十八掌',0),
('黄蓉',0,1,'打狗棍法',0),
('黄药师',1,1,'弹指神通',0),
('欧阳锋',1,1,'蛤蟆功',0),
('梅超风',0,1,'九阴白骨爪',0),
('乔峰',1,2,'降龙十八掌',0),
('段誉',1,2,'六脉神剑',0),
('虚竹',1,2,'天山六阳掌',0),
('王语嫣',0,2,'神仙姐姐',0),
('令狐冲',1,3,'独孤九剑',0),
('任盈盈',0,3,'弹琴',0),
('岳不群',1,3,'华山剑法',0),
('东方不败',0,3,'葵花宝典',0),
('胡斐',1,4,'胡家刀法',0),
('苗若兰',0,4,'黄衣',0),
('程灵素',0,4,'医术',0),
('袁紫衣',0,4,'六合拳',0);
<think>好的,我现在需要帮助用户了解如何在Django项目中创建模型类。首先,我应该回忆一下Django模型的基本概念和作用。Django模型是用来定义数据库结构的,每个模型类对应数据库中的一张表,而类的属性则对应表的字段。用户可能对Django有一定的了解,但作为新手,可能需要详细的步骤和示例。 接下来,我需要确定用户的需求。他们可能想知道从零开始创建模型类的具体步骤,包括如何定义字段、常用的字段类型、元选项的设置以及迁移数据库的过程。同时,用户可能需要一个清晰的示例来帮助理解。 首先,我应该分步骤说明创建模型类的流程。第一步是在应用的models.py文件中定义模型类,这需要导入models模块。然后,继承models.Model类来创建自定义的模型类。接下来,添加字段,这部分需要详细说明常用的字段类型,比如CharField、IntegerField等,以及它们的参数,例如max_length、default等。此外,可能还需要介绍关联关系,比如外键ForeignKey。 然后,需要提到Meta类的作用,比如设置数据库表名、排序方式等。这部分对于用户来说可能不太熟悉,所以需要简单解释。 接下来是迁移数据库的步骤,包括makemigrations和migrate命令,这部分是创建模型后的必要操作,用户必须了解才能将模型应用到数据库中。 最后,提供一个完整的示例代码,让用户能够直观地看到模型类的结构。示例应该包括模型定义、字段类型、外键关联和Meta类的使用。此外,还可以补充一些注意事项,比如模型修改后的重新迁移,以及Django的自动主键字段。 在组织内容时,要确保使用中文,结构清晰,分步骤说明,并用代码示例来增强理解。同时,要检查是否有遗漏的步骤,比如注册应用到settings.py中的INSTALLED_APPS,这对迁移是否成功至关重要,但用户可能在创建应用时已经完成,所以是否需要提醒?可能用户可能忘记,所以补充在注意事项里。 还需要注意LaTeX格式的要求,但当前问题不涉及数学公式,所以可能不需要使用。但用户提供的系统级指令中提到,所有行内数学表达式必须使用$...$,所以如果在回答中有数学相关内容,需要遵守,但此问题可能不涉及,所以可能不需要。 最后,确保回答真实可靠,步骤正确,符合Django的最佳实践。可能还需要提醒用户常见的错误,比如忘记运行迁移命令,或者字段参数设置不当等。</think>在Django项目中创建模型类需遵循以下步骤,通过定义Python类来描述数据库结构: ### 一、创建模型类 1. **定位文件** 在Django应用的`models.py`文件中编写模型类 2. **基本结构** ```python from django.db import models class 模型名(models.Model): # 必须继承models.Model 字段名 = models.字段类型(参数) # 其他字段... ``` ### 二、常用字段类型 | 字段类型 | 说明 | 示例 | |-----------------------|--------------------------------|------------------------------| | `CharField` | 短文本(必须设`max_length`) | `name = models.CharField(max_length=20)` | | `TextField` | 长文本 | `content = models.TextField()` | | `IntegerField` | 整型 | `age = models.IntegerField(default=0)` | | `BooleanField` | 布尔值 | `is_active = models.BooleanField(default=True)` | | `DateTimeField` | 日期时间 | `created = models.DateTimeField(auto_now_add=True)` | | `ForeignKey` | 外键关联 | `author = models.ForeignKey('User', on_delete=models.CASCADE)` | ### 三、关联关系处理 1. **一对多** 使用`ForeignKey`: ```python class Author(models.Model): name = models.CharField(max_length=100) class Book(models.Model): title = models.CharField(max_length=200) author = models.ForeignKey(Author, on_delete=models.CASCADE) ``` 2. **多对多** 使用`ManyToManyField`: ```python class Tag(models.Model): name = models.CharField(max_length=50) class Article(models.Model): title = models.CharField(max_length=200) tags = models.ManyToManyField(Tag) ``` ### 四、Meta类配置 通过内部类设置元数据: ```python class Book(models.Model): # ...字段定义... class Meta: db_table = 'my_books' # 自定义表名 ordering = ['-publish_date'] # 默认按发布日期倒序排列 verbose_name = '图书' # 后台显示名称 ``` ### 五、数据库迁移 1. 生成迁移文件: ```bash python manage.py makemigrations ``` 2. 执行迁移: ```bash python manage.py migrate ``` ### 六、完整示例 ```python from django.db import models class Category(models.Model): name = models.CharField(max_length=50, verbose_name='分类名称') class Meta: verbose_name_plural = '分类' class Product(models.Model): name = models.CharField(max_length=200) price = models.DecimalField(max_digits=10, decimal_places=2) category = models.ForeignKey(Category, on_delete=models.CASCADE) stock = models.PositiveIntegerField(default=0) created_at = models.DateTimeField(auto_now_add=True) def __str__(self): return self.name ``` ### 注意事项 1. 修改模型后必须重新执行迁移命令 2. 每个模型会自动添加`id`字段作为主键 3. 关联模型建议使用字符串引用(避免循环导入) 4. 确保应用已注册到`settings.py`的`INSTALLED_APPS`中 通过模型类定义,Django会自动生成数据库表,后续可通过ORM进行数据库操作,无需直接编写SQL语句。
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值