【django系列学习笔记】Django 模型（M）- (1)模型的定义

时间 2019-11-11

标签 django系列学习笔记 django 模型定义栏目 Python 繁體版

原文原文链接

Django也遵循了MVC的分层原则，不过在作法上略有不一样。
首先模型部分保持不变：Django的模型增只负责把数据传入传出数据库。然而Django里的视图却并非显示数据的最后一步----Django的视图其实更接近MVC里传统意义上的控制器。他们是用来将模型层和表示层（有HTML和Django的模板语言组成）连接在一块儿的python函数。
按Django开发团队的话老说就是：咱们理解的MVC里，视图的做用是描述将要显示给用户的数据。这不只仅是数据看上去的外观，含包括如何表示数据。视图描述的是你能看那些数据，而不是怎么看到它。
换一种说法，Django把表示层一分为二，视图方法定义了要显示模型里的什么数据，而模板则定义了最终信息的显示方式。
而框架本身则担当了控制器的角色--它提供了决定什么视图和什么模板一块儿响应给定请求的机制。python

1、模型的定义

一、基础

    |-每一个模型都是django.db.models.Model 的一个Python 子类。
    |-模型的每一个属性都表示数据库中的一个字段。
    |-Django 提供一套自动生成的用于数据库访问的API；
    |-模型表名为 myapp_modelnamemysql

二、字段

django常见Field Types：
    一、AutoField
    若是没有指明主键，就会产生一个自增的主键。
    二、BigIntegerField
    64位的整型数值，从 -2^63 (-9223372036854775808) 到 2^63-1(9223372036854775807)。
    三、BinaryField
    存储原始二进制数据，仅支持字节分配。功能有限。
    四、BooleanField
    布尔型和NullBooleanField有区别，true/false，本类型不容许出现null。
    五、CharField
    字符串，通常都在建立时写入max_length参数。
    六、CommaSeparatedIntegerField
    逗号分隔的整数，考虑到数据库的移植性，max_length参数应该必选。
    原文解释：A field of integers separated by commas. As in CharField, the max_length argument is required and the note about database portability mentioned there should be heeded.
    七、DateField
    时间，对应Python的datetime.date，额外的参数：DateField.auto_now表示是否每次修改时改变时间，DateField.auto_now_add 表示是否建立时表示时间，通常来讲数据库重要的表都要有这样的字段记录建立字段时间个最后一次改变的时间。关于时间的话，建议timestamp，固然 python的话仍是DateTime吧。
    八、DateTimeField
    对应Python的datetime.datetime，参照参数（7）。
    九、DecimalField
    固定精度的十进制数，通常用来存金额相关的数据。对应python的Decimal，额外的参数包括DecimalField.max_digits和DecimalField.decimal_places ，这个仍是要参照一下mysql的Decimal类型，http://database.51cto.com/art/201005/201651.htm
    例如：price = models.DecimalField(max_digits=8,decimal_places=2)
    十、EmailField
    字符串，会检查是不是合法的email地址
    十一、FileField
    class FileField([upload_to=None, max_length=100, **options])
    存文件的，参数upload_to在1.7以前的一些老版本中必选的
    十二、FloatField
    浮点数，必填参数：max_digits，数字长度；decimal_places，有效位数。
    1三、ImageField
    class ImageField([upload_to=None, height_field=None, width_field=None, max_length=100, **options])
    图片文件类型，继承了FileField的全部属性和方法。参数除upload_to外，还有height_field，width_field等属性。
    1四、IntegerField
    [-2147483648,2147483647 ]的取值范围对Django所支持的数据库都是安全的。
    1五、IPAddressField
    点分十进制表示的IP地址，如10.0.0.1
    1六、GenericIPAddressField
    ip v4和ip v6地址表示，ipv6遵循RFC 4291section 2.2,
    1七、NullBooleanField
    能够包含空值的布尔类型，至关于设置了null=True的BooleanField。
    1八、PositiveIntegerField
    正整数或0类型，取值范围为[0 ,2147483647]
    1九、PositiveSmallIntegerField
    正短整数或0类型，相似于PositiveIntegerField，取值范围依赖于数据库特性，[0 ,32767]的取值范围对Django所支持的数据库都是安全的。
    20、SlugField
    只能包含字母，数字，下划线和连字符的字符串，一般被用于URLs表示。可选参数max_length=50，prepopulate_from用于指示在admin表单中的可选值。db_index，默认为True。
    2一、SmallIntegerField
    小整数字段，相似于IntegerField，取值范围依赖于数据库特性，[-32768 ,32767]的取值范围对Django所支持的数据库都是安全的。
    2二、TextField
    文本类型
    2三、TimeField
    时间，对应Python的datetime.time
    2四、URLField
    存储URL的字符串，默认长度200；verify_exists(True)，检查URL可用性。
    2五、FilePathField
    class FilePathField(path=None[, match=None, recursive=False, max_length=100, **options])
    相似于CharField，可是取值被限制为指定路径内的文件名，path参数是必选的。
    详见官方文档：
    https://docs.djangoproject.com/en/1.8/ref/models/fields/#field-types

    经常使用字段属性
    null
    若是设置为 True , Django 存放一个 NULL 到数据库字段。默认为 False。
    blank
    若是设置为 True , 此 field 容许为 blank （空白），默认为 False。
    要注意，这与 null 不一样。null纯粹是数据库范畴的，而 blank 是数据验证范畴的。若是一个字段的blank=True，表单的验证将容许该字段是空值。若是字段的blank=False，该字段就是必填的。
    choices
    一个2元元组的元组或者列表，若是执行 choices ， Django 的 admin 就会使用选择框而不是标准的 text 框填写这个 field。
    default
    field 的默认值，可使用可调用对象（a callable object），若是使用可调用对象，那么每次建立此 model 的新对象时调用可调用对象。常见如 datatime 。
    help_text
    help_text 的值能够在 admin form 里显示，不过即便不使用 admin ，也能够当作描述文档使用。
    primary_key
    若是为 True ，这个 field 就是此 model 的 primary key 。
    unique
    若是为 True，此 field 在这个 table 里必须惟一。
    verbose_name
    ForeignKey、ManyToManyField 和 OneToOneField 使用此来定义“自述名”。
    git

三、关系

    多对一： ForeignKey
    多对多：ManyToManyField 能够自定义中介模型，源模型的ManyToManyField 字段将使用through 参数指向中介模型
    一对一：OneToOneField 算法

四、模型继承

|-抽象基类：一般，你只想使用父类来持有一些信息，你不想在每一个子模型中都敲一遍。这个类永远不会单独使用，因此你使用抽象基类。没法生成数据表单或者管理器，而且不能实例化或者储存。
    |-多表继承：若是你继承一个已经存在的模型且想让每一个模型具备它本身的数据库表，那么应该使用多表继承。Django 会自动建立一个 OneToOneField字段将子类连接至非抽象的父 model 。若是你想指定连接父类的属性名称，你能够建立你本身的 OneToOneField字段并设置 parent_link=True ，从而使用该字段连接父类。
    |-代理模型：最后，若是你只是想改变模块Python 级别的行为，而不用修改模型的字段，你可使用代理模型。
    |-多重继承：若是多个父类含有 Meta类，只有第一个会被使用，剩下的会忽略掉（Django 1.7以前，继承多个含有id主键字段的模型不会抛出异常，可是会致使数据丢失。）。
    抽象基类：
sql

    from django.db import models
    class CommonInfo(models.Model):
        name = models.CharField(max_length=100)
        age = models.PositiveIntegerField()
        class Meta:
            abstract = True
    class Student(CommonInfo):
        home_group = models.CharField(max_length=5)

元继承（继承基类的Meta）：
数据库

    from django.db import models
    class CommonInfo(models.Model):
        # ...
        class Meta:
            abstract = True
            ordering = ['name']
    class Student(CommonInfo):
        # ...
        class Meta(CommonInfo.Meta):
            db_table = 'student_info'

多表继承：
django

   from django.db import models
    class Place(models.Model):
        name = models.CharField(max_length=50)
        address = models.CharField(max_length=80)
    class Restaurant(Place):
        serves_hot_dogs = models.BooleanField(default=False)
        serves_pizza = models.BooleanField(default=False)

代理继承：
后端

    from django.db import models
    class Person(models.Model):
        first_name = models.CharField(max_length=30)
        last_name = models.CharField(max_length=30)
    class MyPerson(Person):
        class Meta:
            proxy = True
        def do_something(self):
            # ...
            pass

五、Meta 选项介绍

abstract
若是 abstract = True，就表示模型是抽象基类 (abstract base class).安全

    app_label
    若是一个模型位于标准的位置以外（应用的models.py 或models 包），该模型必须定义它属于哪一个应用：
    >=Django 1.7:定义在应用的models 模块之外的模型，再也不须要app_label。app

db_table
该模型所用的数据表的名称

db_tablespace
当前模型所使用的数据库表空间的名字。默认值是项目设置中的DEFAULT_TABLESPACE，若是它存在的话。若是后端并不支持表空间，这个选项能够忽略。

    default_related_name
    >=Django 1.8+ 这个名字会默认被用于一个关联对象到当前对象的关系。默认为 <model_name>_set。
    因为一个字段的反转名称应该是惟一的，当你给你的模型设计子类时，要格外当心。为了规避名称冲突，名称的一部分应该含有'%(app_label)s'和'%(model_name)s'，它们会被应用标签的名称和模型的名称替换，两者都是小写的。详见抽象模型的关联名称。

get_latest_by
模型中某个可排序的字段的名称，好比DateField、DateTimeField或者IntegerField。它指定了Manager的latest()和earliest()中使用的默认字段。

managed
默认为True，意思是Django在migrate命令中建立合适的数据表，而且会在 flush 管理命令中移除它们。换句话说，Django会管理这些数据表的生命周期。
若是是False，Django 就不会为当前模型建立和删除数据表。若是当前模型表示一个已经存在的，经过其它方法创建的数据库视图或者数据表，这会至关有用。这是设置为managed=False时惟一的不一样之处。

    order_with_respect_to
    按照给定的字段把这个对象标记为”可排序的“。这一属性一般用到关联对象上面，使它在父对象中有序。

    ordering
    对象默认的顺序。它是一个字符串的列表或元组。每一个字符串是一个字段名，前面带有可选的“-”前缀表示倒序。前面没有“-”的字段表示正序。使用"?"来表示随机排序。

permissions
设置建立对象时权限表中额外的权限。增长、删除和修改权限会自动为每一个模型建立。它是一个包含二元组的元组或者列表，格式为 (permission_code, human_readable_permission_name)。

default_permissions
>=Django 1.7.默认为('add', 'change', 'delete')。你能够自定义这个列表，好比，若是你的应用不须要默认权限中的任何一项，能够把它设置成空列表。在模型被migrate命令建立以前，这个属性必须被指定，以防一些遗漏的属性被建立。

proxy
若是proxy = True, 做为该模型子类的另外一个模型会被视为代理模型。

select_on_save
默认为False。该选项决定了Django是否采用1.6以前的 django.db.models.Model.save()算法。旧的算法使用SELECT来判断是否存在须要更新的行。而新式的算法直接尝试使用 UPDATE。在一些小几率的状况中，一个已存在的行的UPDATE操做并不对Django可见。好比PostgreSQL的ON UPDATE触发器会返回NULL。这种状况下，新式的算法会在最后执行 INSERT 操做，即便这一行已经在数据库中存在。

unique_together
用来设置的不重复的字段组合。它是一个元组的元组，组合起来的时候必须是惟一的。它在Django后台中被使用，在数据库层上约束数据(好比，在 CREATE TABLE 语句中包含 UNIQUE语句)。

    index_together
    用来设置带有索引的字段组合.index_together = [["pub_date", "deadline"],] 列表中的字段将会创建索引（例如，会在CREATE INDEX语句中被使用）。
    >= Django 1.7.为了方便起见，处理单一字段的集合时，index_together能够是一个一维的列表。

verbose_name
对象的一个易于理解的名称。若是此项没有设置，Django会把类名拆分开来做为自述名，好比CamelCase 会变成camel case，

verbose_name_plural 该对象复数形式的名称。若是此项没有设置，Django 会使用 verbose_name + "s"。