Django-models中的meta選項

ORM對應的類裏面包含另外一個Meta類，而Meta類封裝了一些數據庫的信息。

class UserInfo(models.Model):
        nid = models.AutoField(primary_key=True)
        username = models.CharField(max_length=32)
        class Meta:
            # 數據庫中生成的表名稱 默認 app名稱 + 下劃線 + 類名
            db_table = "table_name"

            # 聯合索引
            index_together = [
                ("pub_date", "deadline"),
            ]

            # 聯合惟一索引
            unique_together = (("driver", "restaurant"),)

            # admin中顯示的表名稱
            verbose_name

            # verbose_name加s
            verbose_name_plural

 

經過一個內嵌類 "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 升序

須要注意的是:不論你使用了多少個字段排序, admin 只使用第一個字段

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".