models.py

from django.db import models

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

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

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

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

在项目的settings.py中激活应用，并设置数据库相关参数。
让django包含你的应用：

告诉django你对模型做了更改，并且将这些更改存储为迁移文件polls/migrations/0001_initial.py:
```
  $python manage.py makemigrations polls
```
可以查看迁移文件执行了哪些sql语句,并不真的在数据库执行：
```
  $python manage.py sqlmigrate polls 0001
```
可以检查项目中的模型是否存在问题：
```
  $python manage.py check
```
在数据库中创建模型,查找还没有被应用的迁移文件然后和数据库同步：
```
  $python manage.py migrate
```

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

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

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

字段命名规则：

不能是python的保留关键字。
字段名中连续的下划线不能超过一个。

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

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

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

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

模型字段类型

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

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

自增字段:

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

普通字段:

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选项才能指定自述名。

ForeignKey 定义多对一关系
OneToOneField 定义一对一关系
ManyToManyField 定义多对多关系

模型字段选项

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

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

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定义模型的元数据。

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

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中使用的选项.

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属性是模型进行数据库查询操作的接口,也叫管理器,用于从数据库获取实例。

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

执行查询

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

创建对象

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')

获取对象

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

查询集求值：

迭代
切片
序列化
repr()
len()
list()
bool()

查询集参考QuerySet类的方法：

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

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

查询集的链式过滤：

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

Model.__unicode__()

python2需要使用__unicode__方法.

def __unicode__(self):
    return u'%s' % self.title

Model.__str__()

python3只需要__str__方法.

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

这段代码兼容python2和python3.

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

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