Django Model Meta options

Django Model Meta options

Django版本：1.7
主要来源：https://docs.djangoproject.com/en/1.7/ref/models/options/

定义方式：

class Foo(models.Model): 
    bar = models.CharField(maxlength=30)

    class Meta: 
    #

1、abstract

如果设置abstract=True则这个模式是一个抽象基类

2、app_label

如果一个 model 定义在默认的 models.py 之外 (例如，如果你的 app 的 models 在 myapp.models 子模块下)，你必须定义 app_label 让 Django 知道它属于哪一个 app

在django1.7中不再需要使用app_label来定议

3、db_table

定义model在数据库中的表名称

db_table = 'music_album'

Django默认通过app名称+_+model的类名生成数据表

例如，如果你有一个 app 叫做 bookstore (使用 manage.py startapp bookstore 创建)，以 及一个 model 定义为 class Book 这样将会创建一个名为 bookstore_book 的数据库表。

如果你的数据库表名称是一个SQL保留字，或者它包含不允许出现在 Python 变量中的字符 (比如-字符)这是没问题的。这是因为 Django 会自动给列名和表名添加引号。

数据库为Mysql时db_table应该使用小写

数据库为oracle时为了适应oracle的30字符限制和匹配ORACLE的惯例，Django可能缩短表名，并把他们全部大写，为了防止这种转换，使用带引号的名称作为db_table值：

db_table ='“name_left_in_lowercase”'

4、db_tablespace

设置数据库表空间，默认是DEFAULT_TABLESPACE。Django不会去创建或生成表空间，仅仅是使用，如果数据库使用不支持表空间，这个选项会被忽略。

5、get_latest_by

用于指定默认的排序字段，支持DateField\DateTimeField\IntegerField

get_latest_by =“ORDER_DATE”

6、managed

默认值为True,这个选项为True时Django可以对数据库表进行 migrate或migrations、删除等操作。在这个时间Django将管理数据库中表的生命周期

如果为False的时候，不会对数据库表进行创建、删除等操作。可以用于现有表、数据库视图等，其他操作是一样的。包括：

如果没有声明主键字段，Django 将自动的为 model 增加一个自增的主键字段。当你使用不被* 管理* 的 models 时，为了避免让将来阅读代码的人迷惑，建议指明所有所有托管在 model 中的字 段与数据库表的关系。

如果两个非托管的 models (managed=False) 之间，使用了 ManyToManyField 关联，就不会创建多对多关系的中间表。然而 如果是一个托管的 model 与另一个非托管的 model 的话，多对多关系 将会 被创建。

如果你需要改变默认的行为，就的显示的定义中间 model 来在数据库中创建中间表(要将 managed 设置为 True)，然后在你的原 model 上使用 ManyToManyField.through 属性指向中间 model，就能实现自定义的多对多关系。

如果你的测试中包含非托管 model (managed=False)，那么在测试之前，你应该要确保在测试 创建时已经创建了正确的数据表。

7、order_with_respect_to

根据给定的字段对 model 排序。在关联关系中,它经常用在根据目标对象对源对象排序的场合。举 个例子，一个 Answer 只关联一个 Question 对象，而一个 question 对象却可以关联多 个 answer 对象。根据 question 对 answer 排序，你应该这么做:

class Answer(models.Model):
    question = models.ForeignKey(Question)
    # ...

    class Meta:
        order_with_respect_to = 'question'

当 order_with_respect_to 被设置时，会提供两个附加的方法用于获取和设置关联对象的排序： get_RELATED_order() 和 set_RELATED_order() ，这其中的 RELATED 是 model 的小 写名字。例如，假定一个 Question 对象关联到多个 Answer 对象，这将返回一个包含 Answer 对象主键的列表:

>>> question = Question.objects.get(id=1)
>>> question.get_answer_order()
[1, 2, 3]

可以通过传入一个 Answer 主键的列表的方式来设置 Question 对象关联的 Answer 对象的顺序:

>>> question.set_answer_order([3, 1, 2])

关联的对象同样有两个方法, get_next_in_order() 和 get_previous_in_order() ， 可 以用来访问那些特定的对象。假定 Answer 对象是以 id 排序的:

>>> answer = Answer.objects.get(id=2)
>>> answer.get_next_in_order()

>>> answer.get_previous_in_order()

改变 order_with_respect_to 时注意
order_with_respect_to 增加了一个名为 _order 的字段(数据库字段)，因此在你进 行 syncdb 操作后，如果你增加或者改变了 order_with_respect_to 需运行 migrate来保证变更。

8、ordering

定义默认的排序列：

ordering = ['-order_date']

如果在字段前加"-"表示降序排列，不加则是升序排列。加?随机排列

可以综合排列:

ordering = ['-pub_date', 'author']

增加排序会影响数据库性能，外键也会包含相应排序

9、permissions

在创建对象时，添加到权限表当中的附加权限信息。Django 自动为每个设置了 admin 的对象创建了添 加，删除和修改的权限。下面这个例子展示了如何添加一个附加的权限 can_deliver_pizzas:

permissions = (("can_deliver_pizzas", "Can deliver pizzas"),)

该项可以是一个列表或一个由两个元组构成的元组，以这样的格式
(permission_code, human_readable_permission_name) 。

10、default_permissions

默认包含('add','change','delete')，你也可自定义权限列表，例如：如果应用程序不需要任何的默认权限，就可以把这个选项设为空列表。为避免权限的遗漏这个选项必须在model生成之前定义。

11、proxy

如果 proxy = True ，表示该 model 是其父类的代理

12、select_on_save

默认值是False，用于决定是否启用django.db.models.Model.save()算法，这个新算法会尝试直接Update,但在一些罕见的情况下，是有问题的，例如PostgreSQL的ON Update触发器返回NULL,在这种情况下，新算法会不管数据是否存在，而执行Insert操作。

13、unique_together

用来设置的不重复的字段组合，必须唯一(将两个字段做联合唯一):

unique_together = (("driver", "restaurant"),)

它是一个字段名称的列表，列表内的字段组合在数据库中是唯一，不重复的，也就是说不可以有两 个对象，它们在列表中的字段值是完全相同的。它被用在 Django admin 后台，在数据库层级约束 数据。(比如，在 CREATE TABLE 语句中包含 UNIQUE 关键字)

为了使用方便，你可以赋给该项一个单独的字段列表的元组:

unique_together = ("driver", "restaurant")

一个 ManyToManyField 不能包含在 unique_together 中。 (这 将会导致它看起来不明不白！) 如果你需要验证关联到 ManyToManyField 字段的唯一性验证，尝试使用 signal(信号) 或者 明确指定 model 的 through 属性。

在验证出错误时会返回unique_together错误

14、index_together

通过字段名集合创建索引：

index_together = [
    ["pub_date", "deadline"],
]

会根据选项生成合适的CREATE INDEX语句

也可以使用便利的写法：

index_together = ["pub_date", "deadline"]

15、verbose_name

指定该对象的一个可读性更好的唯一名字（单数）：

verbose_name = "pizza"

如果没有指定这个选项，会将以驼峰命名的CamelCase转换为camel case

16、verbose_name_plural

指定该对象的一个可读性更好的唯一名字（复数）：

verbose_name_plural = "stories"

默认是verbose_name+"s"