django meta 類的使用方法

標籤：style   color   使用   os   資料   io   

通過一個內嵌類 "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