Django模型層Meta內(nèi)部類詳解

abstract

Options.abstract

如果 abstract = True ,這個(gè) model 就是一個(gè) 抽象基類 耻陕。

app_label

Options.app_label

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

app_label = 'myapp'

db_table

Options.db_table

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

db_table = 'music_album'

數(shù)據(jù)庫(kù)中的表名稱

為了節(jié)省時(shí)間术裸,Django 會(huì)自動(dòng)的使用你的 model class 的名稱和包含這個(gè) model 的 app 名稱來構(gòu)建 數(shù)據(jù)庫(kù)的表名稱采够。一個(gè) model 的數(shù)據(jù)庫(kù)表名稱是通過將 “app label” – 你在 manage.py startapp 中使用的名稱 – 和 model 的類名稱产艾,加上一個(gè)下劃線在他們之間來構(gòu)成喊递。

例如随闪,如果你有一個(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ù)的表名稱铐伴,需要在 class Meta 使用 db_table 參數(shù)來自定義。

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

在 MySQL 中使用小寫字母作為數(shù)據(jù)庫(kù)表名稱

強(qiáng)烈建議你在通過 db_table 重載數(shù)據(jù)庫(kù)表名稱時(shí)泽疆,使用小寫字母户矢,特別是當(dāng)你在使用 MySQL 作為后臺(tái)數(shù)據(jù)庫(kù)時(shí)。查看 MySQL notes 了解更多細(xì)節(jié)殉疼。

db_tablespace

Options.db_tablespace

定義這個(gè) model 所使用的 數(shù)據(jù)庫(kù) 表空間 梯浪。如果在項(xiàng)目的 setting 中定義了 DEFAULT_TABLESPACE 那么它會(huì)使用這個(gè)值。如果后臺(tái)數(shù)據(jù)庫(kù)不支持 表空間瓢娜,這個(gè)選項(xiàng)會(huì)被忽略挂洛。

get_latest_by

Options.get_latest_by

在 model 中指定一個(gè) DateField 或者 DateTimeField 。這個(gè)設(shè)置讓你在使用 model 的 Manager 上的 latest 方法時(shí)眠砾,默認(rèn)使用指定字段來排序虏劲。

例如:

get_latest_by = "order_date"

詳見 latest() 。

managed

Options.managed

默認(rèn)值為 True 褒颈,這意味著 Django 可以使用 syncdb 和 reset 命令 來創(chuàng)建或移除對(duì)應(yīng)的數(shù)據(jù)庫(kù)伙单。換句話說, Django管理 了數(shù)據(jù)庫(kù)的生命周期哈肖。

如果設(shè)置為 False 吻育,Django 將不會(huì)為當(dāng)前 model 創(chuàng)建或者刪除數(shù)據(jù)庫(kù)表。 通常在表示某個(gè) 通過其他方法創(chuàng)建的現(xiàn)有數(shù)據(jù)表時(shí)這會(huì)非常有用淤井。這是當(dāng) managed=False 時(shí) 僅有 的不同之 處布疼。model 在處理所有其他方面的事情時(shí)是完全一致的。這包括

    如果沒有聲明主鍵字段币狠,Django 將自動(dòng)的為 model 增加一個(gè)自增的主鍵字段游两。當(dāng)你使用不被* 管理* 的 models 時(shí),為了避免讓將來閱讀代碼的人迷惑漩绵,建議指明所有所有托管在 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 來在數(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ù)表服鹅。

如果你想更改 model 類中某個(gè) Python 層級(jí)的行為凳兵,你 可以 令 managed=False ,然后創(chuàng) 建該 model 的拷貝企软,在拷貝中定義新的行為留荔。不過在面對(duì)這種情況時(shí)還有個(gè)更好的辦法就是使 用 Proxy models 。

order_with_respect_to

Options.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]

可以通過傳入一個(gè) Answer 主鍵的列表的方式來設(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() , 可 以用來訪問那些特定的對(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 請(qǐng)確保 處理得當(dāng)寥粹。
ordering

Options.ordering

定義了當(dāng)獲取對(duì)象的列表時(shí)变过,對(duì)象的默認(rèn)排序:

ordering = ['-order_date']

這是一個(gè)字符串的元組或列表。沒一個(gè)字符串都是由一個(gè)字段名和一個(gè)可選的表明降序的 “-” 前綴構(gòu)成涝涤。 當(dāng)字段名前面沒有 “-” 時(shí)媚狰,將默認(rèn)使用升序排列。使用 ”?” 將會(huì)隨機(jī)排列阔拳。

例如崭孤,以 pub_date 字段升序排序,可用:

ordering = ['pub_date']

以 pub_date 降序排列時(shí),可用:

ordering = ['-pub_date']

以 pub_date 降序排列辨宠,然后再以 author 升序排列遗锣,可用:

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

Changed in Django 1.4: Django admin 將采用列表/元組中所有的元素; 在 1.4 版之前, 只有第一個(gè)元素被采用。

permissions

Options.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) 墓阀。

proxy

Options.proxy

如果 proxy = True 毡惜,表示該 model 是其父類的代理 model proxy model 。

unique_together

Options.unique_together

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

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

它是一個(gè)字段名稱的列表经伙,列表內(nèi)的字段組合在數(shù)據(jù)庫(kù)中是唯一,不重復(fù)的勿锅,也就是說不可以有兩 個(gè)對(duì)象帕膜,它們?cè)诹斜碇械淖侄沃凳峭耆嗤摹K挥迷?Django admin 后臺(tái)溢十,在數(shù)據(jù)庫(kù)層級(jí)約束 數(shù)據(jù)垮刹。(比如,在 CREATE TABLE 語句中包含 UNIQUE 關(guān)鍵字)

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

unique_together = ("driver", "restaurant")

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

verbose_name

Options.verbose_name

指明一個(gè)易于理解和表述的對(duì)象名稱,單數(shù)形式:

verbose_name = "pizza"

如果這個(gè)值沒有設(shè)置刻剥, Django 將會(huì)使用該 model 的類名的分詞形式作為他的對(duì)象表述名: CamelCase 將會(huì)轉(zhuǎn)換為camel case 遮咖。

verbose_name_plural

Options.verbose_name_plural

對(duì)象的復(fù)數(shù)表述名:

verbose_name_plural = "stories"

如果沒有指定,Django 會(huì)使用 verbose_name + "s" 的形式作為對(duì)象的表述名造虏。
最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
  • 序言:七十年代末盯滚,一起剝皮案震驚了整個(gè)濱河市,隨后出現(xiàn)的幾起案子酗电,更是在濱河造成了極大的恐慌魄藕,老刑警劉巖,帶你破解...
    沈念sama閱讀 223,126評(píng)論 6 520
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件撵术,死亡現(xiàn)場(chǎng)離奇詭異背率,居然都是意外死亡,警方通過查閱死者的電腦和手機(jī),發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 95,421評(píng)論 3 400
  • 文/潘曉璐 我一進(jìn)店門寝姿,熙熙樓的掌柜王于貴愁眉苦臉地迎上來交排,“玉大人,你說我怎么就攤上這事饵筑“Bǎ” “怎么了?”我有些...
    開封第一講書人閱讀 169,941評(píng)論 0 366
  • 文/不壞的土叔 我叫張陵根资,是天一觀的道長(zhǎng)架专。 經(jīng)常有香客問我,道長(zhǎng)玄帕,這世上最難降的妖魔是什么部脚? 我笑而不...
    開封第一講書人閱讀 60,294評(píng)論 1 300
  • 正文 為了忘掉前任,我火速辦了婚禮裤纹,結(jié)果婚禮上委刘,老公的妹妹穿的比我還像新娘。我一直安慰自己鹰椒,他們只是感情好锡移,可當(dāng)我...
    茶點(diǎn)故事閱讀 69,295評(píng)論 6 398
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著漆际,像睡著了一般淆珊。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發(fā)上灿椅,一...
    開封第一講書人閱讀 52,874評(píng)論 1 314
  • 那天套蒂,我揣著相機(jī)與錄音,去河邊找鬼茫蛹。 笑死操刀,一個(gè)胖子當(dāng)著我的面吹牛,可吹牛的內(nèi)容都是我干的婴洼。 我是一名探鬼主播骨坑,決...
    沈念sama閱讀 41,285評(píng)論 3 424
  • 文/蒼蘭香墨 我猛地睜開眼,長(zhǎng)吁一口氣:“原來是場(chǎng)噩夢(mèng)啊……” “哼柬采!你這毒婦竟也來了欢唾?” 一聲冷哼從身側(cè)響起,我...
    開封第一講書人閱讀 40,249評(píng)論 0 277
  • 序言:老撾萬榮一對(duì)情侶失蹤粉捻,失蹤者是張志新(化名)和其女友劉穎礁遣,沒想到半個(gè)月后,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體肩刃,經(jīng)...
    沈念sama閱讀 46,760評(píng)論 1 321
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡祟霍,尸身上長(zhǎng)有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 38,840評(píng)論 3 343
  • 正文 我和宋清朗相戀三年杏头,在試婚紗的時(shí)候發(fā)現(xiàn)自己被綠了。 大學(xué)時(shí)的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片沸呐。...
    茶點(diǎn)故事閱讀 40,973評(píng)論 1 354
  • 序言:一個(gè)原本活蹦亂跳的男人離奇死亡醇王,死狀恐怖,靈堂內(nèi)的尸體忽然破棺而出崭添,到底是詐尸還是另有隱情寓娩,我是刑警寧澤,帶...
    沈念sama閱讀 36,631評(píng)論 5 351
  • 正文 年R本政府宣布呼渣,位于F島的核電站棘伴,受9級(jí)特大地震影響,放射性物質(zhì)發(fā)生泄漏徙邻。R本人自食惡果不足惜排嫌,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 42,315評(píng)論 3 336
  • 文/蒙蒙 一畸裳、第九天 我趴在偏房一處隱蔽的房頂上張望缰犁。 院中可真熱鬧,春花似錦怖糊、人聲如沸帅容。這莊子的主人今日做“春日...
    開封第一講書人閱讀 32,797評(píng)論 0 25
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽并徘。三九已至,卻和暖如春扰魂,著一層夾襖步出監(jiān)牢的瞬間麦乞,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 33,926評(píng)論 1 275
  • 我被黑心中介騙來泰國(guó)打工劝评, 沒想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留姐直,地道東北人。 一個(gè)月前我還...
    沈念sama閱讀 49,431評(píng)論 3 379
  • 正文 我出身青樓蒋畜,卻偏偏與公主長(zhǎng)得像声畏,于是被迫代替她去往敵國(guó)和親。 傳聞我的和親對(duì)象是個(gè)殘疾皇子姻成,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 45,982評(píng)論 2 361

推薦閱讀更多精彩內(nèi)容