django Meta 选项 解释
作者:我就是个世界
发表于:2011-05-07
通过一个内嵌类 "class Meta" 给你的 model 定义元数据, 类似下面这样:
[code]
class Foo(models.Model):
bar = models.CharField(maxlength=30)
class Meta:
# ...
[/code]
Model 元数据就是 "不是一个字段的任何数据" -- 比如排序选项, admin 选项等等.[separator]
下面是所有可能用到的 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
原文:http://tangjun.alwaysdata.net/blog/28/
英文官方:http://programmingexamples.wikidot.com/django-model-layer
[code]
class Foo(models.Model):
bar = models.CharField(maxlength=30)
class Meta:
# ...
[/code]
Model 元数据就是 "不是一个字段的任何数据" -- 比如排序选项, admin 选项等等.[separator]
下面是所有可能用到的 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
原文:http://tangjun.alwaysdata.net/blog/28/
英文官方:http://programmingexamples.wikidot.com/django-model-layer
请发表您的评论