django meta 類的使用方法

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

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

    class Meta: 
        # ...

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

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

db_table 
本模塊在數據庫中對應的表的名字:

db_table = "pizza_orders"

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

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

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

get_latest_by = "order_date"

order_with_respect_to 
標記給定字段的對象是 "orderable" 的.它用於關聯對象以容許他們以父對象指望的方式排序.舉例來講, 若是一個 PizzaToppping 關聯到一個 Pizza 對象, 這樣作:

order_with_respect_to = 'pizza'

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

order_with_respect_to 
將該對象標記爲可按給定字段排序. This is almost always used with related objects to allow them to be ordered with respect to a parent object. 舉例來講, 若是一個 PizzaToppping 關聯到一個 Pizza 對象, 你可使用:

order_with_respect_to = 'pizza'

這就容許 toppings 被排序to be ordered 關於相關的 pizza 對象

ordering 
默認排序字段及排序方式, 用於獲得一個對象列表的任何場合:

ordering = ['-order_date']

這是一個 tuple 或一個字符串列表. 每一個字符串是一個字段名帶及一個可選的前綴 "-" , 這個前綴表示按降序排序(遞減). 若沒有這個前綴,則表示按升序排序.字符串 "?" 表示隨機排序.

舉個例子, 要對 pub_date 字段以升序排列, 這樣作:

ordering = ['pub_date']

要降序排列, 這樣:

ordering = ['-pub_date']

要對 pub_date 降序,而後對 author 升序, 這樣:

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

注意一點,不論你使用了多少個字段排序, admin 只使用第一個字段.

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

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

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

unique_together 
Sets of field names that, taken together, must be unique:

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

這是一個字段列表的列表,這些字段的綜合值必須是惟一的. 這會在 Django admin 層和數據庫層同時作出限制(也就是相關的 UNIQUE 語句會被包括在 CREATE TABLE 語句中).

verbose_name 
是該對象的一個可讀性更好的惟一名字:

verbose_name = "pizza"

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

verbose_name_plural 
對象名字的複數:

verbose_name_plural = "stories"

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

THE REST OF THIS HAS NOT YET BEEN EDITED Table names Automatic primary key fields