模型是关于数据的单一的、最终的数据源。它包含存储的数据的基本字段和行为。通常,每个模型映射到单个数据库表。
- 每一个model十几个继承django.db.models.Model的Python子类
- 每一个model的属性代表一个数据库中的字段
- Django有一个操作数据库的API
Quick example
from djiando.db import models
class Person(models.Model):
first_name = models.CharField(max_lenght=30)
last_name = models.CharField(max_length=30)
first_name和last_name是Person的属性,也是响应的数据库中的字段
以上Person类相当于下面的SQL语句
CREATE TABLE myapp_person(
'id' serial NOT NULL PRIMARY KEY
'first_name' varchar(30) NOT NULL
'last_name' varchar(30) NOT NULL
)
Django默认会为每一个类(表)加一个主键 myapp是你Django App的名称 默认已App的名称为表的前缀
需要使用一下命令同步数据库(在相应的目录下)
python manage.py makemigrations
python manage.py migrate
Fields(字段)
定义字段时不要有Django中model API的关键字(方法、属性等)冲突,例如 clean,save和detele。
在model中的字段类型都是一个Field类的实例(一般都用Field类的子类 例如CharField)。正确的选择Field types决定存储在数据中字段的类型(INTEGER,VARCHAR等)。
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 文件
Field options 字段选项
每一个字段都有一组特定字段的参数,例如CharField及其子类,需要至少传递一个max_length的参数作为相应的数据库中varchar的长度。
每一个字段都有一个通用的选项可以设置,这些选项的设置与数据库的设置息息相关,常用的设置项如下:
- null 如果是True,表示Django允许该字段存储NULL,默认是False
- blank 此字段是否接受空白内容,默认值是False
blank与null的意义是不一样的,blank是与值相关,如果blank=True表示此字段可以接受一个空白的值,如果是False表示此字段必须填写 - choices 已选项的方式最为此字段的候选值
候选值的定义方式
YEAR_IN_SCHOOL_CHOICES=(
('FR','Freshman'),
('SO','Sophomore'),
('JR','Junior'),
('SR','Senior'),
('GR','Graduate'),
)
from django.db import models
class Person(models.Model):
SHIRT_SIZES=(
('S','Small'),
('M','Medium'),
('L','Large'),
)
name = models.CharField(max_length=60)
shirt_size = models.CharField(max_lenth=1,choices= SHIRT_SIZES)
>>>p = Person(name='Fred',shirt_size='L')
>>>p.save()
>>>p.shirt_size
'L'
>>>p.get_shirt_size_display()
'Large'
- default 设置字段的默认值
- help_text 字段的求助信息
- primary_key 设置数据表中的主键,默认False
from django.db import models
class Fruit(models.Model):
name = models.CharField(max_length=100,primary_key=True)
>>>f = Fruit.objects.create(name='Apple')
>>>f.name = 'Pear'
>>>f.save()
>>>f.objects.values_list('name',flat=True)
>>>['Apple','Pear']
其中flat=True 表示返回单个的值而不是元组。多个字段是不能用
- unique 设置次字段是否为唯一值
Automatic primary key fields
默认的Django为每个model设置默认自动递增主键
id = models.AutoField(primary_key=True)
Verbose field names
每个filed type(除了ForeignKey, ManyToManyField and OneToOneField )都能在第一个参数设置verbose name
一个访问人能够读懂的名字,用于显示在网页上的。如果verbose_nam设置的话。 默认是字段响应的属性名(下划线用空格代替)
first_name = models.CharField("person's first name",max_length=30)
>>>这是的verbose_name的名字为 person's first name
first_name = models.CharField(max_length=30)
>>>verbose_name的名字为 first name
ForeignKey, ManyToManyField and OneToOneField 等verbose name的设置需要用keyword的方式设置
poll = models.ForeignKey(Poll,on_delete=models.CASCADE,verbose_name='the related poll',)
auto_now 和 auto_now_add (用于时间字段类型)
auto_now 自动创建---无论添加或修改,都是当前操作的时间
auto_now_add 自动创建---永远是创建时的时间
db_column 数据库中的字段名称
db_index = True 数据库索引
editable=True 在Admin里是否可编辑
error_messages=None 错误提示
auto_created=False 自动创建
validators=[] 自定义数据格式验证
upload-to 上传文件路径