一 ORM基础知识
1 在同一个模型类中的字段
from django.db import models
class OneModelFields(models.Model):
# 自增长字段，int型
Auto = models.AutoField()
BigAuto = models.BigAutoField()
# 二进制数据
Binary = models.BinaryField()
# 布尔型
Boolean = models.BooleanField() # 不为空
NullBoolean = models.NullBooleanField() # 允许为空
# 整型
PositiveSmallInteger = models.PositiveSmallIntegerField() # 5个字节正整数
SmallInteger = models.SmallIntegerField() # 6个字节整数
PositiveInteger = models.PositiveIntegerField() # 10个字节正整数
Integer = models.IntegerField() # 11个字节整数
BigInteger = models.BigIntegerField() # 20个字节整数
# 字符串类型
Char = models.CharField() # 对应数据库 varchar
Test = models.TextField() # 对应数据库 longtext
# 时间日期类型
Date = models.DateField() # 年月日
DateTime = models.DateTimeField() # 年月日时分秒
Duration = models.DurationField() # 表示一段时间，int型，底层python timedelta实现
# 浮点型
Float = models.FloatField()
Decimal = models.DecimalField()
# 其他字段
Email = models.EmailField()
Image = models.ImageField()
File = models.FileField()
FilePath = models.FilePathField()
URL = models.URLField()
GenericIPAddress = models.GenericIPAddressField()
2 关系型字段
"""
一对一： OneToOne
多对一： ForeignKey
多对多： ManyToMany
"""
class A(models.Model):
onetoon = models.OneToOneField(OneModelFields)
class B(models.Model):
foreign = models.ForeignKey(A)
class C(models.Model):
manytomany = models.ManyToManyField(B)
3 字段共有的参数
- db_column: 在数据库中的字段名称，默认和变量同名
- verbose_name: 后台显示名称
- primary_key=True：主键
- null=True: 允许字段为空，默认False
- blank=True: 提交表单可以为空，默认False，此参数为True，null参数必须为True
- db_index=True: 设置索引，默认False
- help_text: 表单帮助信息
- editable: 该字段是否可编辑，默认为True
- unique: 字段唯一，默认False
- default: 默认值
class OneModelFields(models.Model): # 表名：appname_onemodelfield
PositiveSmallInteger = models.PositiveSmallIntegerField(db_column="age", verbose_name="年龄")
SmallInteger = models.SmallIntegerField(primary_key=True)
Integer = models.IntegerField(null=True, blank=True)
BigInteger = models.BigIntegerField(unique=True, db_index=True, default=0)
Char = models.CharField(help_text="表单帮助信息")
Test = models.TextField(editable=False)
4 个别字段具有的参数
字符串型
- max_length: 必须指定数值的参数，utf8编码的最大长度
时间日期类型
- unique_for_date: 日期必须唯一
- unique_for_month: 月份必须唯一
- unique_for_year: 年份必须唯一
- auto_now_add: 增加记录时的时间
- auto_now: 更新当前记录的时间
浮点型
- max_digits: DecimalField字段必须指定，一共多少位
- decimal_places: DecimalField字段必须指定，小数点位数
class OneModelFields(models.Model):
# 字符串类型
Char = models.CharField(max_length=100) # 对应数据库 varchar
Test = models.TextField() # 对应数据库 longtext
# 时间日期类型
Date = models.DateField(unique_for_date=True, auto_now=True) # 年月日
DateTime = models.DateTimeField(unique_for_year=True, unique_for_month=True, auto_now_add=True) # 年月日时分秒
Duration = models.DurationField() # 表示一段时间，int型，底层python timedelta实现
# 浮点型
Float = models.FloatField()
Decimal = models.DecimalField(max_length=4, decimal_places=2) # 例如 12.11
5 关系型字段参数
class A(models.Model):
""" related_name: 反向查询，父表查子表
子表A，父表OneModelFields
通过OneModelFields查询A的数据
"""
onetoon = models.OneToOneFields(OneModelFields, related_name="one")
class B(models.Model):
"""on_delete 的六种操作
1. models.CASCADE: 将定义有外键的模型对象同时删除 ，django模板的默认操作
2. model.PROTECT: 阻止上面的删除操作，但是弹出ProtectedError异常
3. models.SET_NULL: 将外键字段设为null，只有当字段设置了null=True时，方可使用该值
4. models.SET_DEFAULT: 将外键字段设为默认值，只有当字段设置了default参数时，方可使用
5. models.DO_NOTHING: 什么也不做
6. models.SET: 设置为一个传递给SET()的值或者一个回调函数的返回值，注意大小写
"""
foreign = models.ForeignKey(A, on_delete=models.CASCADE) # 删除级联
foreign = models.ForeignKey(A, on_delete=models.PROTECT)
foreign = models.ForeignKey(A, on_delete=models.SET_NULL, null=True, blank=True) # 删除置空
foreign = models.ForeignKey(A, on_delete=models.SET_DEFAULT, default=0)
foreign = models.ForeignKey(A, on_delete=models.DO_NOTHING)
foreign = models.ForeignKey(A, on_delete=models.SET)
6 自关联
class AddressInfo(models.Model):
""" 地址信息
id：记录主键，会自动生成
address：存储省、市或者县(区)的名称：
pid：存储本条信息关联的一条记录id
例如：一条记录为：id=0, address="江苏省", pid=null
另外一条为：id=1, address="南京市", pid=0
再来一条： id=2, address="江宁区", pid=1
"""
address = models.CharField(max_length=200, null=True, blank=True, verbose_name="地址")
pid = models.ForeignKey('self', null=True, blank=True, verbose_name="自关联字段")
def __str__(self):
return self.address
7 元数据Mate
class AddressInfos(models.Model):
address = models.CharField(max_length=200, null=True, blank=True, verbose_name="地址")
pid = models.ForeignKey('self', null=True, blank=True, verbose_name="自关联字段")
note = models.CharField(max_length=200, null=True, blank=True, verbose_name="说明")
def __str__(self):
return self.address
class Meta:
db_table = "addressinfo" # 表的名称
ordering = 'pid' # 排序字段
verbose_name = "省市县地址信息"
verbose_name_plural = verbose_name # 复数
# abstract = True # 基类用于继承，默认为False
unique_together = ("address", "note") # 联合唯一健，还可以用二维元组 ((), ())
app_label = 'app_name' # 模型类属于哪一个应用
# db_tablespace # 定义数据库表空间的名称
二 模型类开发实例
以慕课网为例，抽象出四张表，关系如下
image.png
以上模型对应的model部分如下：
from django.db import models
class Teacher(models.Model):
"""
讲师信息表
"""
nickname = models.CharField(max_length=30, primary_key=True, db_index=True, verbose_name="昵称")
introduction = models.TextField(default="这位同学很懒，么有签名的说~", verbose_name="简介")
fans = models.PositiveIntegerField(default=0, verbose_name="粉丝数")
created_at = models.DateTimeField(auto_now_add=True, verbose_name="创建时间")
updated_at = models.DateTimeField(auto_now=True, verbose_name="更新时间")
class Meta:
verbose_name = "讲师信息表"
verbose_name_plural = verbose_name
def __str__(self):
return self.nickname
class Course(models.Model):
"""
课程信息表
"""
title = models.CharField(max_length=100, primary_key=True, db_index=True, verbose_name="课程名")
type = models.CharField(choices=((1, "实战课"), (2, "免费课"), (0, "其他")), max_length=1, default=0, verbose_name="课程类型")
price = models.PositiveSmallIntegerField(verbose_name="价格")
volume = models.BigIntegerField(verbose_name="销量")
online = models.DateField(verbose_name="上线时间")
created_at = models.DateTimeField(auto_now_add=True, verbose_name="创建时间")
updated_at = models.DateTimeField(auto_now=True, verbose_name="更新时间")
# 多对一的关系字段
# 当讲师被删除时，删除讲师的课程
teacher = models.ForeignKey(Teacher,null=True, blank=True, on_delete=models.CASCADE, verbose_name="课程的教师") # 删除级联
class Meta:
verbose_name = "课程信息表"
verbose_name_plural = verbose_name
def __str__(self):
return f"{self.get_type_display()}-{self.title}" # 示例：实战课-django零基础入门
class Student(models.Model):
"""
"学生信息表"
"""
nickname = models.CharField(max_length=30, primary_key=True, db_index=True, verbose_name="昵称")
age = models.PositiveSmallIntegerField(verbose_name="年龄")
gender = models.CharField(choices=((1, "男"), (2, "女"), (0, "保密")), default=0, max_length=1, verbose_name="性别")
study_time = models.PositiveIntegerField(default="0", verbose_name="学习时长(h)")
created_at = models.DateTimeField(auto_now_add=True, verbose_name="创建时间")
updated_at = models.DateTimeField(auto_now=True, verbose_name="更新时间")
# 多对多的关系字段
course = models.ManyToManyField(Course, verbose_name="学生学习的课程")
class Meta:
verbose_name = "学生信息表"
verbose_name_plural = verbose_name
def __str__(self):
return self.nickname
class TeacherAssistant(models.Model):
"""
助教信息表
"""
nickname = models.CharField(max_length=30, primary_key=True, db_index=True, verbose_name="昵称")
hobby = models.CharField(max_length=100, null=True, blank=True, verbose_name="爱好")
created_at = models.DateTimeField(auto_now_add=True, verbose_name="创建时间")
updated_at = models.DateTimeField(auto_now=True, verbose_name="更新时间")
# 一对一的关系字段
teacher = models.OneToOneField(Teacher,null=True, blank=True, on_delete=models.SET_NULL, verbose_name="助教对应的教师") # 删除置空
class Meta:
verbose_name = "助教信息表"
verbose_name_plural = verbose_name
def __str__(self):
return self.nickname
