ORM 字段和参数

合集 - Django web框架(16)
1.django 初识2.Django 连接数据库、迁移数据库、连接池3.Django 之 ORM表关系创建、请求生命周期4.一文搞懂 CGI, FastCGI, WSGI, uWSGI5.Django之url函数、有名无名分组、反向解析、url转换器6.序列化、CBV源码分析、模版层7.Django之models模型层18.Django之models模型层2
9.ORM 字段和参数
10.简单图书管理系统11.Ajax技术+layer弹窗12.MTV和MVC、contentType、批量插入数据13.cookie和session14.Django之CBV装饰器、中间件、csrf 跨站请求伪造15.Django之Auth模块16.BBS项目
收起

一、ORM字段

1、常用字段

AutoField
int自增列，必须填入参数 primary_key=True。当model中如果没有自增列，则自动会创建一个列名为id的列。 

IntegerField
一个整数类型,范围在 -2147483648 to 2147483647。

CharField
字符类型，必须提供max_length参数， max_length表示字符长度。

DateField
日期字段，日期格式 YYYY-MM-DD，相当于Python中的datetime.date()实例。

DateTimeField
日期时间字段，格式 YYYY-MM-DD HH:MM[:ss[.uuuuuu]][TZ]，相当于Python中的datetime.datetime()实例

FileField

- 字符串，路径保存在数据库，文件上传到指定目录

- 参数： upload_to = "" 上传文件的保存路径（服务器路径）

storage = None 存储组件，默认django.core.files.storage.FileSystemStorage

2、实例

?
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
AutoField(Field)
- int自增列，必须填入参数 primary_key=True
 
BigAutoField(AutoField)
- bigint自增列，必须填入参数 primary_key=True
 
注：当model中如果没有自增列，则自动会创建一个列名为id的列
from django.db import models
 
class UserInfo(models.Model):
# 自动创建一个列名为id的且为自增的整数列
username = models.CharField(max_length=32)
 
class Group(models.Model):
# 自定义自增列
nid = models.AutoField(primary_key=True)
name = models.CharField(max_length=32)
 
SmallIntegerField(IntegerField):
- 小整数 -32768 ～ 32767
 
PositiveSmallIntegerField(PositiveIntegerRelDbTypeMixin, IntegerField)
- 正小整数 0 ～ 32767
IntegerField(Field)
- 整数列(有符号的) -2147483648 ～ 2147483647
 
PositiveIntegerField(PositiveIntegerRelDbTypeMixin, IntegerField)
- 正整数 0 ～ 2147483647
 
BigIntegerField(IntegerField):
- 长整型(有符号的) -9223372036854775808 ～ 9223372036854775807
 
BooleanField(Field)
- 布尔值类型
 
NullBooleanField(Field):
- 可以为空的布尔值
 
CharField(Field)
- 字符类型
- 必须提供max_length参数， max_length表示字符长度
 
TextField(Field)
- 文本类型参数
null：布尔值，指定该字段是否允许为空。默认为False。
blank：布尔值，指定该字段是否允许在表单中为空。默认为False。
db_index：布尔值，指定是否在数据库中为该字段创建索引。默认为False。
default：默认值，当没有提供字段值时使用的默认值。
editable：布尔值，指定字段是否可以在Admin中编辑。默认为True。
help_text：字段的帮助文本，通常在表单中显示。
verbose_name：字段的人类可读名称，通常在表单和Admin中显示。
validators：指定一组验证器，用于验证字段的值。
unique：布尔值，指定字段的值是否必须在整个表中唯一。默认为False。
 
EmailField(CharField)：
- 字符串类型，Django Admin以及ModelForm中提供验证机制
 
IPAddressField(Field)
- 字符串类型，Django Admin以及ModelForm中提供验证 IPV4 机制
 
GenericIPAddressField(Field)
- 字符串类型，Django Admin以及ModelForm中提供验证 Ipv4和Ipv6
- 参数：
protocol，用于指定Ipv4或Ipv6， 'both',"ipv4","ipv6"
unpack_ipv4， 如果指定为True，则输入::ffff:192.0.2.1时候，可解析为192.0.2.1，开启此功能，需要protocol="both"
 
URLField(CharField)
- 字符串类型，Django Admin以及ModelForm中提供验证 URL
 
SlugField(CharField)
- 字符串类型，Django Admin以及ModelForm中提供验证支持 字母、数字、下划线、连接符（减号）
 
CommaSeparatedIntegerField(CharField)
- 字符串类型，格式必须为逗号分割的数字
 
UUIDField(Field)
- 字符串类型，Django Admin以及ModelForm中提供对UUID格式的验证
 
FilePathField(Field)
- 字符串，Django Admin以及ModelForm中提供读取文件夹下文件的功能
- 参数：
path,                      文件夹路径
match=None,                正则匹配
recursive=False,           递归下面的文件夹
allow_files=True,          允许文件
allow_folders=False,       允许文件夹
 
ImageField(FileField)
- 字符串，路径保存在数据库，文件上传到指定目录
- 参数：
upload_to = ""      上传文件的保存路径
storage = None      存储组件，默认django.core.files.storage.FileSystemStorage
width_field=None,   上传图片的高度保存的数据库字段名（字符串）
height_field=None   上传图片的宽度保存的数据库字段名（字符串）
 
DateTimeField(DateField)
- 日期+时间格式 YYYY-MM-DD HH:MM[:ss[.uuuuuu]][TZ]
 
DateField(DateTimeCheckMixin, Field)
- 日期格式      YYYY-MM-DD
 
TimeField(DateTimeCheckMixin, Field)
- 时间格式      HH:MM[:ss[.uuuuuu]]
 
DurationField(Field)
- 长整数，时间间隔，数据库中按照bigint存储，ORM中获取的值为datetime.timedelta类型
 
FloatField(Field)
- 浮点型
 
DecimalField(Field)
- 10进制小数
- 参数：
max_digits，小数总长度
decimal_places，小数位长度
 
BinaryField(Field)
- 二进制类型

二、ORM字段参数

1、ORM字段参数

?
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
null                数据库中字段是否可以为空
db_column           数据库中字段的列名
db_tablespace
default             数据库中字段的默认值
primary_key         数据库中字段是否为主键
db_index            数据库中字段是否可以建立索引
unique              数据库中字段是否可以建立唯一索引
unique_for_date     数据库中字段【日期】部分是否可以建立唯一索引
unique_for_month    数据库中字段【月】部分是否可以建立唯一索引
unique_for_year     数据库中字段【年】部分是否可以建立唯一索引
 
verbose_name        Admin中显示的字段名称
blank               Admin中是否允许用户输入为空
editable            Admin中是否可以编辑
help_text           Admin中该字段的提示信息
choices             Admin中显示选择框的内容，用不变动的数据放在内存中从而避免跨表操作
如：gf = models.IntegerField(choices=[(0, '何穗'),(1, '大表姐'),],default=1)
 
error_messages      自定义错误信息（字典类型），从而定制想要显示的错误信息；
字典健：null, blank, invalid, invalid_choice, unique, and unique_for_date
如：{'null': "不能为空.", 'invalid': '格式错误'}
 
validators          自定义错误验证（列表类型），从而定制想要的验证规则
from django.core.validators import RegexValidator
from django.core.validators import EmailValidator,URLValidator,DecimalValidator,\
MaxLengthValidator,MinLengthValidator,MaxValueValidator,MinValueValidator
如：
test = models.CharField(
max_length=32,
error_messages={
'c1': '优先错信息1',
'c2': '优先错信息2',
'c3': '优先错信息3',
},
validators=[
RegexValidator(regex='root_\d+', message='错误了', code='c1'),
RegexValidator(regex='root_112233\d+', message='又错误了', code='c2'),
EmailValidator(message='又错误了', code='c3'), ]
                            )

2、choices参数的使用（重点）

作用

类似于一些字段：性别、学历、客户来源、是否上学、是否结婚等字段，能够被列举完。

存入数据库中是数字或者字母等，读取出来是汉字（字符串）。

案例

?
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
from django.db import models
 
# Create your models here.
class UserInfo(models.Model):
    username = models.CharField(max_length=64)
 
    # 增加一个性别字段:不要这样存字符串类型的，存数字， 1 2 3 男
 
    gender_choices = (
        (1, '男'),
        (2, '女'),
        (3, '未知'),
    )
    '''该字段所存储的范围大小还是取决于字段类型的大小范围'''
    gender = models.SmallIntegerField(choices=gender_choices)  # 1 2 3
    """我们想实现的效果是：存的时候是数字，读出来是对应的文本内容"""
 
    # 定义一个分数的字段：A：优秀 B:良好 C:及格 D:不及格
    score_choices = (
        ('A', '优秀'),
        ('B', '良好'),
        ('C', '及格'),
        ('D', '不及格'),
    )
    # 字段类型如何选择：就选择跟('A', '优秀')第一个参数错存得类型一致就行
    score = models.CharField(max_length=64, choices=score_choices, default='A')

读取数据

obj.get_字段名_display()

?
1
2
instance = models.Userinfo.objects.get(pk=1)
print(instance.get_gender_display())  # 获取人类可读标签

实际案例

三、关系字段

1、ForeignKey 一对多字段。

外键类型在ORM中用来表示外键关联关系，一般把ForeignKey字段设置在 ‘一对多’中’多’的一方。
ForeignKey可以和其他表做关联关系同时也可以和自身做关联关系。

参数： 

to 设置要关联的表

to_field 设置要关联的表的字段

related_name 反向操作时，使用的字段名，用于代替原反向查询时的’表名_set’。
?
1
2
3
4
5
class Student(models.Model):
    name = models.CharField(max_length=32)
    theclass = models.ForeignKey(to="Classes", related_name="students")
 
models.Classes.objects.first().students.all()

related_query_name  反向查询操作时，使用的连接前缀，用于替换表名。

on_delete  当删除关联表中的数据时，当前表与其关联的行的行为。
 　　　  models.CASCADE 删除关联数据，与之关联也删除
　　　　models.DO_NOTHING 删除关联数据，引发错误IntegrityError
　　　　models.PROTECT 删除关联数据，引发错误ProtectedError
　　　　models.SET_NULL 删除关联数据，与之关联的值设置为null（前提FK字段需要设置为可空）
　　　　models.SET_DEFAULT 删除关联数据，与之关联的值设置为默认值（前提FK字段需要设置默认值）
　　　　models.SET
　　　　删除关联数据， a. 与之关联的值设置为指定值，设置：models.SET(值) b. 与之关联的值设置为可执行对象的返回值，设置：models.SET(可执行对象)

db_constraint  是否在数据库中创建外键约束，默认为True。

2、OneToOneField 一对一字段 

3、ManyToManyField  用于表示多对多的关联关系。在数据库中通过第三张表来建立关联关系

多对多关联关系的三种方式（酌情选择）

方式一：自己创建第三张表，分别通过外键关联书和作者（全手动）

推荐使用全手动的创建方式，可扩展性高

第三张表需要我们自己手动创建，不会在自动创建了

优势：扩展性非常好

劣势：不能使用四个方法 add set remove clear

?
1
2
3
4
5
6
7
8
9
10
11
12
13
class Book(models.Model):
    title = models.CharField(max_length=32, verbose_name="书名")
 
class Author(models.Model):
    name = models.CharField(max_length=32, verbose_name="作者姓名")
 
# 自己创建第三张表，分别通过外键关联书和作者
class Author2Book(models.Model):
    author = models.ForeignKey(to="Author")
    book = models.ForeignKey(to="Book")
 
    class Meta:
        unique_together = ("author", "book")

方式二：通过ManyToManyField自动创建第三张表（全自动）

扩展性不好，可以使用四个方法 add set remove clear

?
1
2
3
4
5
6
7
class Book(models.Model):
    title = models.CharField(max_length=32, verbose_name="书名")
 
# 通过ORM自带的ManyToManyField自动创建第三张表
class Author(models.Model):
    name = models.CharField(max_length=32, verbose_name="作者姓名")
    books = models.ManyToManyField(to="Book", related_name="authors")

方式三：设置ManyTomanyField并指定自行创建的第三张表（半自动）

支持正反向查询的，但是不支持那四个方法

?
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
class Book(models.Model):
    title = models.CharField(max_length=32, verbose_name="书名")
 
# 自己创建第三张表，并通过ManyToManyField指定关联
class Author(models.Model):
    name = models.CharField(max_length=32, verbose_name="作者姓名")
    books = models.ManyToManyField(to="Book", through="Author2Book", through_fields=("author", "book"))
    # through_fields接受一个2元组（'field1'，'field2'）：
    # 其中field1是定义ManyToManyField的模型外键的名（author），field2是关联目标模型（book）的外键名。
 
class Author2Book(models.Model):
    author = models.ForeignKey(to="Author")
    book = models.ForeignKey(to="Book")
 
    class Meta:
        unique_together = ("author", "book")

注：

Author 表定义了作者的属性，包括 name 作为作者的姓名。另外，使用 ManyToManyField 来创建与 Book 表之间的多对多关系。

through： 指定中间关联表的名称为 Author2Book，

through_fields ：指定在中间关联表中用来关联 Author 和 Book 模型的外键字段。　　

 

posted @   凡人半睁眼  阅读(26)  评论(0)  编辑  收藏  举报
相关博文：
·  Django 之 ORM表关系创建、请求生命周期
·  路飞学城之多方式登录、短信验证码、课程
·  ORM中常用的字段和参数
·  字段和字段参数介绍 单表增加
·  模型层-常用字段
阅读排行：
· winform 绘制太阳，地球，月球 运作规律
· TypeScript + Deepseek 打造卜卦网站：技术与玄学的结合
· AI 智能体引爆开源社区「GitHub 热点速览」
· 写一个简单的SQL生成工具
· Manus的开源复刻OpenManus初探
历史上的今天：
2019-08-06 NFS网络文件系统

阅读目录(Content)

此页目录为空

点击右上角即可分享
微信分享提示