Django Model Meta options

Django版本：1.7
主要來(lái)源：https://docs.djangoproject.com/en/1.7/ref/models/options/

定義方式：

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

    class Meta: 
    #

1、abstract

如果設(shè)置abstract=True則這個(gè)模式是一個(gè)抽象基類

2趣斤、app_label

如果一個(gè) model 定義在默認(rèn)的 models.py 之外 (例如荠耽，如果你的 app 的 models 在 myapp.models 子模塊下)，你必須定義 app_label 讓 Django 知道它屬于哪一個(gè) app

在django1.7中不再需要使用app_label來(lái)定議

3谁鳍、db_table

定義model在數(shù)據(jù)庫(kù)中的表名稱

db_table = 'music_album'

Django默認(rèn)通過(guò)app名稱+_+model的類名生成數(shù)據(jù)表

例如殷绍，如果你有一個(gè) app 叫做 bookstore (使用 manage.py startapp bookstore 創(chuàng)建)，以 及一個(gè) model 定義為 class Book 這樣將會(huì)創(chuàng)建一個(gè)名為 bookstore_book 的數(shù)據(jù)庫(kù)表窄做。

如果你的數(shù)據(jù)庫(kù)表名稱是一個(gè)SQL保留字吃衅，或者它包含不允許出現(xiàn)在 Python 變量中的字符 (比如-字符)這是沒問題的往踢。這是因?yàn)?Django 會(huì)自動(dòng)給列名和表名添加引號(hào)。

數(shù)據(jù)庫(kù)為Mysql時(shí)db_table應(yīng)該使用小寫

數(shù)據(jù)庫(kù)為oracle時(shí)為了適應(yīng)oracle的30字符限制和匹配ORACLE的慣例捐晶，Django可能縮短表名菲语，并把他們?nèi)看髮懲纾瑸榱朔乐惯@種轉(zhuǎn)換惑灵，使用帶引號(hào)的名稱作為db_table值：

db_table ='“name_left_in_lowercase”'

4、db_tablespace

設(shè)置數(shù)據(jù)庫(kù)表空間眼耀，默認(rèn)是DEFAULT_TABLESPACE英支。Django不會(huì)去創(chuàng)建或生成表空間，僅僅是使用哮伟，如果數(shù)據(jù)庫(kù)使用不支持表空間干花，這個(gè)選項(xiàng)會(huì)被忽略。

5楞黄、get_latest_by

用于指定默認(rèn)的排序字段池凄，支持DateField\DateTimeField\IntegerField

get_latest_by =“ORDER_DATE”

6、managed

默認(rèn)值為True,這個(gè)選項(xiàng)為True時(shí)Django可以對(duì)數(shù)據(jù)庫(kù)表進(jìn)行 migrate或migrations鬼廓、刪除等操作肿仑。在這個(gè)時(shí)間Django將管理數(shù)據(jù)庫(kù)中表的生命周期

如果為False的時(shí)候，不會(huì)對(duì)數(shù)據(jù)庫(kù)表進(jìn)行創(chuàng)建碎税、刪除等操作尤慰。可以用于現(xiàn)有表雷蹂、數(shù)據(jù)庫(kù)視圖等伟端，其他操作是一樣的。包括：

如果沒有聲明主鍵字段匪煌，Django 將自動(dòng)的為 model 增加一個(gè)自增的主鍵字段责蝠。當(dāng)你使用不被* 管理* 的 models 時(shí)，為了避免讓將來(lái)閱讀代碼的人迷惑萎庭，建議指明所有所有托管在 model 中的字 段與數(shù)據(jù)庫(kù)表的關(guān)系玛歌。

如果兩個(gè)非托管的 models (managed=False) 之間，使用了 ManyToManyField 關(guān)聯(lián)擎椰，就不會(huì)創(chuàng)建多對(duì)多關(guān)系的中間表支子。然而 如果是一個(gè)托管的 model 與另一個(gè)非托管的 model 的話，多對(duì)多關(guān)系 將會(huì) 被創(chuàng)建达舒。

如果你需要改變默認(rèn)的行為值朋，就的顯示的定義中間 model 來(lái)在數(shù)據(jù)庫(kù)中創(chuàng)建中間表(要將 managed 設(shè)置為 True)叹侄，然后在你的原 model 上使用 ManyToManyField.through 屬性指向中間 model，就能實(shí)現(xiàn)自定義的多對(duì)多關(guān)系昨登。

如果你的測(cè)試中包含非托管 model (managed=False)趾代，那么在測(cè)試之前，你應(yīng)該要確保在測(cè)試 創(chuàng)建時(shí)已經(jīng)創(chuàng)建了正確的數(shù)據(jù)表丰辣。

7撒强、order_with_respect_to

根據(jù)給定的字段對(duì) model 排序。在關(guān)聯(lián)關(guān)系中,它經(jīng)常用在根據(jù)目標(biāo)對(duì)象對(duì)源對(duì)象排序的場(chǎng)合笙什。舉 個(gè)例子飘哨，一個(gè) Answer 只關(guān)聯(lián)一個(gè) Question 對(duì)象，而一個(gè) question 對(duì)象卻可以關(guān)聯(lián)多 個(gè) answer 對(duì)象琐凭。根據(jù) question 對(duì) answer 排序芽隆，你應(yīng)該這么做:

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

    class Meta:
        order_with_respect_to = 'question'

當(dāng) order_with_respect_to 被設(shè)置時(shí)，會(huì)提供兩個(gè)附加的方法用于獲取和設(shè)置關(guān)聯(lián)對(duì)象的排序： get_RELATED_order() 和 set_RELATED_order() 统屈，這其中的 RELATED 是 model 的小 寫名字胚吁。例如，假定一個(gè) Question 對(duì)象關(guān)聯(lián)到多個(gè) Answer 對(duì)象愁憔，這將返回一個(gè)包含 Answer 對(duì)象主鍵的列表:

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

可以通過(guò)傳入一個(gè) Answer 主鍵的列表的方式來(lái)設(shè)置 Question 對(duì)象關(guān)聯(lián)的 Answer 對(duì)象的順序:

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

關(guān)聯(lián)的對(duì)象同樣有兩個(gè)方法, get_next_in_order() 和 get_previous_in_order() 腕扶， 可 以用來(lái)訪問那些特定的對(duì)象。假定 Answer 對(duì)象是以 id 排序的:

>>> answer = Answer.objects.get(id=2)
>>> answer.get_next_in_order()
<Answer: 3>
>>> answer.get_previous_in_order()
<Answer: 1>

改變 order_with_respect_to 時(shí)注意
order_with_respect_to 增加了一個(gè)名為 _order 的字段(數(shù)據(jù)庫(kù)字段)吨掌，因此在你進(jìn) 行 syncdb 操作后半抱，如果你增加或者改變了 order_with_respect_to 需運(yùn)行 migrate來(lái)保證變更。

8思犁、ordering

定義默認(rèn)的排序列：

ordering = ['-order_date']

如果在字段前加"-"表示降序排列代虾，不加則是升序排列。加?隨機(jī)排列

可以綜合排列:

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

增加排序會(huì)影響數(shù)據(jù)庫(kù)性能激蹲，外鍵也會(huì)包含相應(yīng)排序

9棉磨、permissions

在創(chuàng)建對(duì)象時(shí)，添加到權(quán)限表當(dāng)中的附加權(quán)限信息学辱。Django 自動(dòng)為每個(gè)設(shè)置了 admin 的對(duì)象創(chuàng)建了添 加乘瓤，刪除和修改的權(quán)限。下面這個(gè)例子展示了如何添加一個(gè)附加的權(quán)限 can_deliver_pizzas:

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

該項(xiàng)可以是一個(gè)列表或一個(gè)由兩個(gè)元組構(gòu)成的元組策泣，以這樣的格式
(permission_code, human_readable_permission_name) 衙傀。

10、default_permissions

默認(rèn)包含('add','change','delete')萨咕，你也可自定義權(quán)限列表统抬，例如：如果應(yīng)用程序不需要任何的默認(rèn)權(quán)限，就可以把這個(gè)選項(xiàng)設(shè)為空列表。為避免權(quán)限的遺漏這個(gè)選項(xiàng)必須在model生成之前定義聪建。

11钙畔、proxy

如果 proxy = True ，表示該 model 是其父類的代理

12金麸、select_on_save

默認(rèn)值是False擎析，用于決定是否啟用django.db.models.Model.save()算法，這個(gè)新算法會(huì)嘗試直接Update,但在一些罕見的情況下挥下，是有問題的揍魂，例如PostgreSQL的ON Update觸發(fā)器返回NULL,在這種情況下，新算法會(huì)不管數(shù)據(jù)是否存在棚瘟，而執(zhí)行Insert操作现斋。

13、unique_together

用來(lái)設(shè)置的不重復(fù)的字段組合解取，必須唯一(將兩個(gè)字段做聯(lián)合唯一):

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

它是一個(gè)字段名稱的列表步责，列表內(nèi)的字段組合在數(shù)據(jù)庫(kù)中是唯一返顺，不重復(fù)的禀苦，也就是說(shuō)不可以有兩 個(gè)對(duì)象，它們?cè)诹斜碇械淖侄沃凳峭耆嗤乃烊怠Ｋ挥迷?Django admin 后臺(tái)振乏，在數(shù)據(jù)庫(kù)層級(jí)約束 數(shù)據(jù)。(比如秉扑，在 CREATE TABLE 語(yǔ)句中包含 UNIQUE 關(guān)鍵字)

為了使用方便慧邮，你可以賦給該項(xiàng)一個(gè)單獨(dú)的字段列表的元組:

unique_together = ("driver", "restaurant")

一個(gè) ManyToManyField 不能包含在 unique_together 中。 (這 將會(huì)導(dǎo)致它看起來(lái)不明不白舟陆！) 如果你需要驗(yàn)證關(guān)聯(lián)到 ManyToManyField 字段的唯一性驗(yàn)證误澳，嘗試使用 signal(信號(hào)) 或者 明確指定 model 的 through 屬性。

在驗(yàn)證出錯(cuò)誤時(shí)會(huì)返回unique_together錯(cuò)誤

14秦躯、index_together

通過(guò)字段名集合創(chuàng)建索引：

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

會(huì)根據(jù)選項(xiàng)生成合適的CREATE INDEX語(yǔ)句

也可以使用便利的寫法：

index_together = ["pub_date", "deadline"]

15忆谓、verbose_name

指定該對(duì)象的一個(gè)可讀性更好的唯一名字（單數(shù)）：

verbose_name = "pizza"

如果沒有指定這個(gè)選項(xiàng)，會(huì)將以駝峰命名的CamelCase轉(zhuǎn)換為camel case

16踱承、verbose_name_plural

指定該對(duì)象的一個(gè)可讀性更好的唯一名字（復(fù)數(shù)）：

verbose_name_plural = "stories"

默認(rèn)是verbose_name+"s"