abstract

Options.abstract

如果 abstract = True ，這個 model 就是一個 抽象基類 。

app_label

Options.app_label

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

app_label = 'myapp'

db_table

Options.db_table

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

db_table = 'music_album'

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

為了節(jié)省時間，Django 會自動的使用你的 model class 的名稱和包含這個 model 的 app 名稱來構(gòu)建 數(shù)據(jù)庫的表名稱。一個 model 的數(shù)據(jù)庫表名稱是通過將 “app label” – 你在 manage.py startapp 中使用的名稱 – 和 model 的類名稱，加上一個下劃線在他們之間來構(gòu)成。

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

如果想自定義數(shù)據(jù)庫的表名稱，需要在 class Meta 使用 db_table 參數(shù)來自定義。

如果你的數(shù)據(jù)庫表名稱是一個SQL保留字，或者它包含不允許出現(xiàn)在 Python 變量中的字符 (比如連字 符)這是沒問題的。這是因為 Django 會自動給列名和表名添加引號。

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

強烈建議你在通過 db_table 重載數(shù)據(jù)庫表名稱時，使用小寫字母，特別是當(dāng)你在使用 MySQL 作為后臺數(shù)據(jù)庫時。查看 MySQL notes 了解更多細(xì)節(jié)。

db_tablespace

Options.db_tablespace

定義這個 model 所使用的 數(shù)據(jù)庫 表空間 。如果在項目的 setting 中定義了 DEFAULT_TABLESPACE 那么它會使用這個值。如果后臺數(shù)據(jù)庫不支持 表空間，這個選項會被忽略。

get_latest_by

Options.get_latest_by

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

例如:

get_latest_by = "order_date"

詳見 latest() 。

managed

Options.managed

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

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

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

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

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

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

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

order_with_respect_to

Options.order_with_respect_to

根據(jù)給定的字段對 model 排序。在關(guān)聯(lián)關(guān)系中,它經(jīng)常用在根據(jù)目標(biāo)對象對源對象排序的場合。舉 個例子，一個Answer 只關(guān)聯(lián)一個 Question 對象，而一個 question 對象卻可以關(guān)聯(lián)多 個 answer 對象。根據(jù) question 對 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è)置關(guān)聯(lián)對象的排序：get_RELATED_order() 和 set_RELATED_order() ，這其中的 RELATED 是 model 的小 寫名字。例如，假定一個Question 對象關(guān)聯(lián)到多個 Answer 對象，這將返回一個包含 Answer 對象主鍵的列表:

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

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

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

關(guān)聯(lián)的對象同樣有兩個方法, get_next_in_order() 和 get_previous_in_order() ， 可 以用來訪問那些特定的對象。假定 Answer 對象是以 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 時注意

order_with_respect_to 增加了一個名為 _order 的字段(數(shù)據(jù)庫字段)，因此在你進 行 syncdb 操作后，如果你增加或者改變了 order_with_respect_to 請確保 處理得當(dāng)。
ordering

Options.ordering

定義了當(dāng)獲取對象的列表時，對象的默認(rèn)排序:

ordering = ['-order_date']

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

例如，以 pub_date 字段升序排序，可用:

ordering = ['pub_date']

以 pub_date 降序排列時，可用:

ordering = ['-pub_date']

以 pub_date 降序排列，然后再以 author 升序排列，可用:

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

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

permissions

Options.permissions

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

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

該項可以是一個列表或一個由兩個元組構(gòu)成的元組，以這樣的格式(permission_code, human_readable_permission_name) 。

proxy

Options.proxy

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

unique_together

Options.unique_together

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

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

它是一個字段名稱的列表，列表內(nèi)的字段組合在數(shù)據(jù)庫中是唯一，不重復(fù)的，也就是說不可以有兩 個對象，它們在列表中的字段值是完全相同的。它被用在 Django admin 后臺，在數(shù)據(jù)庫層級約束 數(shù)據(jù)。(比如，在 CREATE TABLE 語句中包含 UNIQUE 關(guān)鍵字)

為了使用方便，你可以賦給該項一個單獨的字段列表的元組:

unique_together = ("driver", "restaurant")

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

verbose_name

Options.verbose_name

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

verbose_name = "pizza"

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

verbose_name_plural

Options.verbose_name_plural

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

verbose_name_plural = "stories"

如果沒有指定，Django 會使用 verbose_name + "s" 的形式作為對象的表述名。