models.py

1
from django.db import models

django模型是和数据库关联的,代码放在models.py,数据库信息在settings.py中统一配置即可。

每个模型对应数据库唯一的一张表,是django.db.models.Model的子类。

每个模型实例代表数据库中的一条特定记录.

模型的每个属性都表示为数据库中的一个字段。

  • 在项目的settings.py中激活应用,并设置数据库相关参数。

  • 让django包含你的应用:

    告诉django你对模型做了更改,并且将这些更改存储为迁移文件polls/migrations/0001_initial.py:

    1
    
    $python manage.py makemigrations polls

    可以查看迁移文件执行了哪些sql语句,并不真的在数据库执行:

    1
    
    $python manage.py sqlmigrate polls 0001

    可以检查项目中的模型是否存在问题:

    1
    
    $python manage.py check

    在数据库中创建模型,查找还没有被应用的迁移文件然后和数据库同步:

    1
    
    $python manage.py migrate

模型的字段类型和字段选项

模型的每个属性都表示为数据库的一个字段,是Field子类的某个实例。

模型的字段还有一些选项。

字段命名规则: 1. 不能是python的保留关键字。 2. 字段名中连续的下划线不能超过一个。

访问其它应用的模型,导入即可:

1
from <other-aplication>.models import <module-name>

模型字段类型和选项参考:

http://python.usyiyi.cn/documents/django_182/ref/models/fields.html#common-model-field-options

模型字段类型

字段的类型都是Field类的子类:

每个字段都接受一个可选的位置参数(一般是第一个),叫字段的自述名,如果不指定就默认是字段名字(下划线换成空格)。

自增字段:

1
2
3
AutoField
# 默认django会每个模型添加一个自增主键字段,如果你显示设置一个自增主键字段就不会默认再添加,每个模型只能有一个主键字段。
# id = models.AutoField(primary_key=True)

普通字段:

 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
BigIntegerField
BinaryField
BooleanField
CharField
CommaSeparatedIntegerField
DateField
DateTimeField
DecimalField
DurationField
EmailField
FileField
FilePathField
FloatField
GenericIPAddressField
IPAddressField
ImageField
IntegerField
NullBooleanField
PositiveIntegerField
PositiveSmallIntegerField
SlugField
SmallIntegerField
TextField
TimeField
URLField
UUIDField

关系字段:

django定义了一系列字段类型描述数据库之间的关联:

这三个字段要求第一个参数是模型类,用verbose_name选项才能指定自述名。

1
2
3
ForeignKey 定义多对一关系
OneToOneField 定义一对一关系
ManyToManyField 定义多对多关系

模型字段选项

django定义的字段的通用的选项:

每个字段都有特定的选项,也有通用的选项,特定参数参考文档。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
Field.null    django将空值以NULL存储到数据库中,默认是false
Field.blank    该字段允许为空白,默认false
Field.primary_key    true表示该字段为模型的主键字段,默认是false
Field.unique    true表示该字段在表中必须有唯一值,默认是false
Field.unique_for_date
Field.unique_for_month
Field.unique_for_year
Field.choices    可迭代结构,给字段提供选项
Field.default    该字段默认值
Field.help_text    额外的help文本
Field.editable    false表示该字段不会出现在admin,默认是true
Field.error_messages    重写默认抛出的错误信息
Field.verbose_name    该字段可读性更高的名称
Field.validators    该字段要运行的一个Validator的列表
Field.db_column
Field.db_index
Field.db_tablespace

模型元选项

使用内部类Meta定义模型的元数据。

模型元数据是任何不是字段的数据,比如排序选项等。

1
2
3
4
5
6
7
from django.db import models
class Ox(models.Model):
    horn_length = models.IntegerField()
    ...
    class Meta:
        ordering = ["horn_length"]
        verbose_name_plural = "oxen"

模型的元选项:

http://python.usyiyi.cn/translate/django_182/ref/models/options.html

在元类Meta中使用的选项.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
Options.abstract = True 表示模型是抽象基类, 数据库不会创建这个表
Options.db_table 该模型所用的数据表的名称
Options.db_tablespace
Options.default_related_name
Options.get_latest_by
Options.managed
Options.order_with_respect_to
Options.ordering = ['字段名', '-字段名'] 对象的默认顺序, -表示倒序
Options.permissions
Options.default_permissions
Options.proxy
Options.select_on_save
Options.unique_together
Options.index_together
Options.verbose_name 对象的一个易于理解的名字
Options.verbose_name_plural 该对象复数形式的名字

模型的属性

模型的属性是表级别的,是对表的操作.

http://python.usyiyi.cn/translate/django_182/ref/models/class.html

每个模型类都要添加一个Manager实例,如果不显示添加,django就会默认添加objects属性,包含Manager实例。

Manager或object属性是模型进行数据库查询操作的接口,也叫管理器,用于从数据库获取实例。

1
2
3
4
from django.db import models
class Foo(models.Model):
    # 显示添加
    bar = models.Manager()

执行查询

一旦建立数据模型,django会自动生成一套抽象的API,用于创建,检索,更新和删除对象.

创建对象

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
q = Question(question_text='content', pub_date='date')
q.save()

q = Question(question_text='content')
q.pub_date='date'
q.save()

Question.objects.create(question_text="content", pub_date='date')

# 防止重复,不存在就创建,返回(object, True),存在返回(object, False)
Question.objects.get_or_create(question_text='content', pub_date='date')

获取对象

通过模型中的管理器构造一个查询集来从数据库获取对象.

查询集求值: 1. 迭代 2. 切片 3. 序列化 4. repr() 5. len() 6. list() 7. bool()

查询集参考QuerySet类的方法:

http://python.usyiyi.cn/translate/django_182/ref/models/querysets.html#queryset-api

1
2
3
4
5
6
7
8
9
# 获取表中所有对象
Question.objects.all()
# 切片获取部分
Question.objects.all()[:10]
# 获取单个
Question.objects.get(question_text='content')
# 过滤
Question.objects.filter(**kwargs)
Question.objects.exclude(**kwargs)

查询集的链式过滤:

1
2
3
Question.objects.all().exists()
Question.objects.all().order_by('name')
Question.objects.filter(**kwargs).filter(**kwargs)

模型的方法

模型的方法是对模型的实例的操作.

模型中可以自定义方法,可以使用预定义的自动生成的方法,也可以覆盖预定义的方法。

预定义方法参考:

http://python.usyiyi.cn/translate/django_182/ref/models/instances.html

1
Model.__unicode__()

python2需要使用unicode方法.

1
2
3
4
def __unicode__(self):
    return u'%s' % self.title

Model.__str__()

python3只需要str方法.

1
2
def __str__(self):
    return '%s' % self.title

这段代码兼容python2和python3.

python_2_unicode_compatible是一个用于类的装饰器,在类中定义str并返回文本.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
from __future__ import unicode_literals
from django.utils.encoding import python_2_unicode_compatible

@python_2_unicode_compatible
class Question(models.Model):
    title = models.CharField('title', max_length=256)
    ...

    def __str__(self):
        return self.title

Model.__eq__()

Model.__hash__()

Model.get_absolute_url()

Model.get_FOO_display()

Model.get_next_by_FOO(**kwargs)

Model.get_previous_by_FOO(**kwargs)

Model.DoesNotExist