参考链接:https://www.cnblogs.com/maociping/p/5255834.html
http://www.ruanyifeng.com/blog/2019/02/orm-tutorial.html
参考资料:
django基础http://www.cnblogs.com/wupeiqi/articles/5237704.html
django进阶篇http://www.cnblogs.com/wupeiqi/articles/5246483.html
一、建立数据库模型类
定义模型类
- 模型类被定义在"应用/models.py"文件中。
- 模型类必须继承自Model类,位于包django.db.models中。
接下来首先以"图书-英雄"管理为例进行演示。
(~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~)
1.在model里创建模型类。(继承models.Model)
from django.db import models
# 角色表
class Role(models.Model):
role_name = models.CharField(max_length=32, verbose_name='角色')
class Meta:
db_table = 'tb_role'
verbose_name = '角色'
verbose_name_plural = verbose_name
def __str__(self):
return self.role_name
# 班级表
class ClassRoom(models.Model):
classroom = models.CharField(max_length=20, verbose_name='班级')
address = models.CharField(max_length=32, verbose_name='地址')
class Meta:
db_table = 'tb_clasroom'
verbose_name = '班级'
verbose_name_plural = verbose_name
def __str__(self):
return self.classroom
# 学生表
class User(models.Model):
name = models.CharField(max_length=12, verbose_name='姓名')
age = models.IntegerField(verbose_name='年龄')
home = models.CharField(max_length=255, null=True, verbose_name='家乡')
#一对多关系
role = models.ManyToManyField(Role, null=True)
#多对多关系
class_room = models.ForeignKey(ClassRoom, on_delete=models.CASCADE, null=True)
class Meta:
db_table = 'tb_user'
verbose_name = '用户' # verbose_name就是在admin中显示对应的名称
verbose_name_plural = verbose_name
def __str__(self):
return self.name
(~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~)
Model数据库连表结构可看博客:
https://blog.csdn.net/HarryMing/article/details/96847031
https://www.cnblogs.com/chenchao1990/p/5309890.html
(~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~)
(1) 数据库表名
模型类如果未指明表名,Django默认以 小写app应用名_小写模型类名 为数据库表名。
可通过tb_table 指明数据库表名。
(~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~)
(2) 关于主键
django会为表创建自动增长的主键列,每个模型只能有一个主键列,如果使用选项设置某属性为主键列后django不会再创建自动增长的主键列。
默认创建的主键列属性为id,可以使用pk代替,pk全拼为primary key。
(~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~)
(3) 属性命名限制
-
不能是python的保留关键字。
-
不允许使用连续的下划线,这是由django的查询方式决定的。
-
定义属性时需要指定字段类型,通过字段类型的参数指定选项,语法如下:
属性=models.字段类型(选项)
(~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~)
(4)字段类型
一般数据库中字段类型大概5种(字符串/数字/浮点型/时间类型/布尔类型),但Django为了在后台admin中可以操作数据库,同时为了限制在admin中对数据库的无效操作,Model中设置了很多种数据类型。
(~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~)
1、models.AutoField 自增列=int(11)
如果没有的话,默认会生成一个名称为id的列,如果要显示的定义一个自增列,必须把该列设置为主键(primary_key=True)
2、models.CharField 字符串类型字段 必须加max_length参数
3、models.BooleanField 布尔类型字段=tinyint(1) 不能为空,Blank=True
4、models.ComaSeparatedIntegerField 用逗号分割的数字类型=varchar 继承CharField,所以必须加max_lenght参数
5、models.DateField 日期字段类型date
参数auto_now=True表示每次更新都会更新这个时间;参数auto_now_add表示只是第一次创建时添加,之后的更新不再改变
6、models.DateTimeField 日期字段类型datetime 同DateField的参数
7、models.Decimal 十进制小数类型=decimal
必须指定整数位max_digits和小数位decimal_places
8、models.EmailField 字符串类型(正则表达式邮箱)=varchar 对字符串进行正则表达式验证
9、models.FloatField 浮点类型=double
10、models.IntegerField 整形
11、models.BigIntegerField 长整形
integer_field_ranges = {
'SmallIntegerField': (-32768, 32767),
'IntegerField': (-2147483648, 2147483647),
'BigIntegerField': (-9223372036854775808, 9223372036854775807),
'PositiveSmallIntegerField': (0, 32767),
'PositiveIntegerField': (0, 2147483647),
}
12、models.IPAddressField 字符串类型(ip4正则表达式)
13、models.GenericIPAddressField 字符串类型(ip4和ip6是可选的)
参数protocol可以是:both、ipv4、ipv6 验证时,会根据设置进行报错
14、models.NullBooleanField 允许为空的布尔类型
15、models.PositiveIntegerFiel 正Integer
16、models.PositiveSmallIntegerField 正smallInteger
17、models.SlugField 减号、下划线、字母、数字
18、models.SmallIntegerField 数字
数据库中的字段有:tinyint、smallint、int、bigint
19、models.TextField 字符串=longtext
20、models.TimeField 时间 HH:MM[:ss[.uuuuuu]]
21、models.URLField 字符串类型,地址正则表达式
22、models.BinaryField 二进制
23、models.ImageField 图片
24、models.FilePathField 文件
(~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~)
models.DateTimeField/models.GenericIPAddressField/models.ImageField使用字段说明
class UserInfo(models.Model):
name = models.CharField(max_length=32)
ctime = models.DateTimeField(auto_now=True) #每当你创建一行数据时,Django就会在该行数据中增加一个ctime字段
uptime = models.DateTimeField(auto_now_add=True) #当前表任何一行数据有更新时,Django就会自动更新该字段.
#下面两项是新增的字段,注意新增时参数的设置,否则在命令行创建数据库时报错,null=True表示在数据库中该字段可以为空,default='xxx'表示默认值
email_1 = models.EmailField(max_length=32,null=True)
email_2 = models.EmailField(max_length=32,default='aaa@qq.com')
#新增字段,blank=True表示admin后台可以为空
ip = models.GenericIPAddressField(protocol='ipv4',null=True,blank=True) #upload_to='upload'表示用户上传数据存储的位置,这里需要注意:在数据库中实际保存的并不是文件,而是文件存放的路径
img = models.ImageField(null=True,blank=True,upload_to='upload')
(~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~)
(5) 参数类型
(~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~)
1、null=True 数据库中字段是否可以为空
2、blank=True django的Admin中添加数据时是否可允许空值
3、primary_key=False 主键,对AutoField设置主键后,就会代替原来默认的自增id列
4、auto_now和auto_now_add
auto_now 自动创建---无论添加或修改,都是当前操作的时间
auto_now_add 自动创建---永远是创建时的时间
5、choices
GENDER_CHOICE = (
(u'M', u'Male'),
(u'F', u'Female'),
)
gender = models.CharField(max_length=2,choices=GENDER_CHOICE)
6、max_length 最大长度
7、default 默认值
8、verbose_name Admin中字段的显示名称
9、name|db_column 数据库中的字段名称
10、unique=True 不允许重复
11、db_index = True 数据库索引
12、editable=True 在Admin里是否可编辑
13、error_messages=None 错误提示
14、auto_created=False 自动创建
15、help_text 在Admin中提示帮助信息
16、validators=[] 验证
17、upload-to 文件上传路径
(~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~)
(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