Django model 中的 class Meta 詳解

經過一個內嵌類 "class Meta" 給你的 model 定義元數據, 相似下面這樣:

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

    class Meta: 
        # ...

　　

Model 元數據就是 "不是一個字段的任何數據" -- 好比排序選項, admin 選項等等.

下面是全部可能用到的 Meta 選項. 沒有一個選項是必需的. 是否添加 class Meta 到你的 model 徹底是可選的.

 

 

app_label

app_label這個選項只在一種狀況下使用，就是你的模型類不在默認的應用程序包下的models.py文件中，這時候你須要指定你這個模型類是那個應用程序的。好比你在其餘地方寫了一個模型類，而這個模型類是屬於myapp的，那麼你這是須要指定爲：

app_label='myapp'

 

db_table

db_table是用於指定自定義數據庫表名的。Django有一套默認的按照必定規則生成數據模型對應的數據庫表名，若是你想使用自定義的表名，就經過這個屬性指定，好比：

table_name='my_owner_table' 

 

若不提供該參數, Django 會使用 app_label + '_' + module_name 做爲表的名字.

若你的表的名字是一個 SQL 保留字, 或包含 Python 變量名不容許的字符--特別是連字符 --不要緊. Django 會自動在幕後替你將列名字和表名字用引號引發來.

 

db_tablespace

有些數據庫有數據庫表空間，好比Oracle。你能夠經過db_tablespace來指定這個模型對應的數據庫表放在哪一個數據庫表空間。

 

get_latest_by

因爲Django的管理方法中有個lastest()方法，就是獲得最近一行記錄。若是你的數據模型中有 DateField 或 DateTimeField 類型的字段，你能夠經過這個選項來指定lastest()是按照哪一個字段進行選取的。

一個 DateField 或 DateTimeField 字段的名字. 若提供該選項, 該模塊將擁有一個 get_latest() 函數以獲得 "最新的" 對象(依據那個字段):

get_latest_by = "order_date"

 

managed

因爲Django會自動根據模型類生成映射的數據庫表，若是你不但願Django這麼作，能夠把managed的值設置爲False。

默認值爲True,這個選項爲True時Django能夠對數據庫表進行 migrate或migrations、刪除等操做。在這個時間Django將管理數據庫中表的生命週期

若是爲False的時候，不會對數據庫表進行建立、刪除等操做。能夠用於現有表、數據庫視圖等，其餘操做是同樣的。

order_with_respect_to

這個選項通常用於多對多的關係中，它指向一個關聯對象。就是說關聯對象找到這個對象後它是通過排序的。指定這個屬性後你會獲得一個get_XXX_order()和set_XXX_order（）的方法,經過它們你能夠設置或者回去排序的對象。

舉例來講, 若是一個 PizzaToppping 關聯到一個 Pizza 對象, 這樣作:

order_with_respect_to = 'pizza'

...就容許 toppings 依照相關的 pizza 來排序.

ordering  

這個字段是告訴Django模型對象返回的記錄結果集是按照哪一個字段排序的。好比下面的代碼：

ordering=['order_date'] 
# 按訂單升序排列
ordering=['-order_date'] 
# 按訂單降序排列，-表示降序
ordering=['?order_date'] 
# 隨機排序，？表示隨機
ordering = ['-pub_date', 'author']
# 對 pub_date 降序,而後對 author 升序

 

permissions

permissions主要是爲了在Django Admin管理模塊下使用的，若是你設置了這個屬性可讓指定的方法權限描述更清晰可讀。

要建立一個對象所須要的額外的權限. 若是一個對象有 admin 設置, 則每一個對象的添加,刪除和改變權限會人(依據該選項)自動建立.下面這個例子指定了一個附加權限: can_deliver_pizzas:

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

這是一個2-元素 tuple 的tuple或列表, 其中兩2-元素 tuple 的格式爲:(permission_code, human_readable_permission_name).

unique_together

unique_together這個選項用於：當你須要經過兩個字段保持惟一性時使用。這會在 Django admin 層和數據庫層同時作出限制(也就是相關的 UNIQUE 語句會被包括在 CREATE TABLE 語句中)。好比：一個Person的FirstName和LastName二者的組合必須是惟一的，那麼須要這樣設置：

unique_together = (("first_name", "last_name"),)

 

verbose_name

verbose_name的意思很簡單，就是給你的模型類起一個更可讀的名字：

verbose_name = "pizza"

若未提供該選項, Django 則會用一個類名字的 munged 版原本代替:

CamelCase becomes camel case

 

verbose_name_plural

這個選項是指定，模型的複數形式是什麼，好比：

 

verbose_name_plural = "stories"

 

若未提供該選項, Django 會使用 verbose_name + "s".