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