1. 程式人生 > >Django 第十二課 【class meta】

Django 第十二課 【class meta】

nbsp keyword 生命周期 元數據 mod 數據庫 完全 創建 together

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 升序

需要註意的是:不論你使用了多少個字段排序, 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".

Django 第十二課 【class meta】