三 Django模型层之Meta

模型的Meta选项

本文阐述所有可用的元数据选项,你可以在模型的Meta类中设置他们

Meta选项

abstract

如果为True,就表示抽象基类

app_label

如果模型在INSTALLED_APPS之外被定义,则必须通过app_label声明它属于哪个app

db_table

该模型所用数据表的名称。Django默认使用你的 model class 的名称和包含这个 model 的 app 名称来构建 数据库的表名称。

db_tablespace

表空间名字。默认值是项目设置中的<span>DEFAULT_TABLESPACE</span>

default_related_name

关联对象反向查找源对象时用到的名称,默认为<model_name>_set。也可以直接模型类中定义一个related_name来覆盖默认值

get_latest_by

Django管理器给我们提供有latest()和earliest()方法,分别表示获取最近一个和最前一个数据对象。但是,如何来判断最近一个和最前面一个呢?也就是根据什么来排序呢?get_latest_by元数据选项帮你解决这个问题,它可以指定一个类似 DateFieldDateTimeField或者IntegerField这种可以排序的字段,作为latest()和earliest()方法的排序依据,从而得出最近一个或最前面一个对象。

managed

该元数据默认值为True,表示Django将按照既定的规则,管理数据库表的生命周期。如果设置为False,将不会针对当前模型创建和删除数据库表。在某些场景下,这可能有用,但更多时候,你可以忘记该选项。

ordering

对象的排列顺序,在获取对象的列表时使用

它是一个字符串的列表或元组。 每个字符串是一个字段名,前面带有可选的“-”前缀表示倒序。 前面没有“-”的字段表示正序。 使用字符串“?”来随机排序。

permissions

用于当创建对象时增加额外的权限,Django会为每个模型自动创建,增删该3个权限,它是一个包含二元组的元组或者列表,格式为 <span>(permission_code, <span>human_readable_permission_name)</span></span>

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

default_permissions

Django默认给所有的模型设置('add', 'change', 'delete')的权限,也就是增删改。你可以自定义这个选项,比如设置为一个空列表,表示你不需要默认的权限,但是这一操作必须在执行migrate命令之前。

proxy

如果设置了proxy = True,表示使用代理模式的模型继承方式。具体内容与abstract选项一样

required_db_features

声明模型依赖的数据库功能。比如['gis_enabled'],表示模型的建立依赖GIS功能。

required_db_vendor

声明模型支持的数据库。Django默认支持sqlite, postgresql, mysql, oracle

select_on_save

决定是否使用1.6版本之前的django.db.models.Model.save()算法保存对象。默认值为False。这个选项我们通常不用关心。

indexes

要在模型上定义的索引的列表:

from django.db import models

class Customer(models.Model):
    first_name = models.CharField(max_length=)
    last_name = models.CharField(max_length=)

    class Meta:
        indexes = [
            models.Index(fields=['last_name', 'first_name']),
            models.Index(fields=['first_name'], name='first_name_idx'),
        ]

unique_together

用来设置的不重复的字段组合,它是一个元组的元组,组合起来的时候必须是唯一的。

这个元数据是非常重要的一个!它等同于数据库的联合约束!

举个例子,假设有一张用户表,保存有用户的姓名、出生日期、性别和籍贯等等信息。要求是所有的用户唯一不重复,可现在有好几个叫“张伟”的,如何区别它们呢?(不要和我说主键唯一,这里讨论的不是这个问题)

我们可以设置不能有两个用户在同一个地方同一时刻出生并且都叫“张伟”,使用这种联合约束,保证数据库能不能重复添加用户(也不要和我谈小概率问题)。在Django的模型中,如何实现这种约束呢?

使用unique_together,也就是联合唯一!

比如:

unique_together = (('name', 'birth_day', 'address'),)

这样,哪怕有两个在同一天出生的张伟,但他们的籍贯不同,也就是两个不同的用户。一旦三者都相同,则会被Django拒绝创建。这一元数据经常被用在admin后台,并且强制应用于数据库层面。

unique_together接收一个二维的元组((xx,xx,xx,...),(),(),()...),每一个元素都是一个元组,表示一组联合唯一约束,可以同时设置多组约束。为了方便,对于只有一组约束的情况下,可以简单地使用一维元素,例如:

unique_together = ('name', 'birth_day', 'address')

联合唯一约束无法作用于普通的多对多字段。

verbose_name

用于设置模型对象的直观、人类可读的名称。可以用中文

如果此项没有设置,Django会把类名拆分开来作为自述名,比如<span>CamelCase</span> 会变成<span>camel <span>case</span></span>

verbose_name_plural

模型对象的复数名,比如“apples”。因为我们中文通常不区分单复数,所以保持和verbose_name一致也可以

如果此项没有设置,Django 会使用 <span>verbose_name</span>+ <span>"s"</span>

只读的Meta属性

label

对象的表示,返回<span>app_label.object_name</span>,例如<span>'polls.Question'</span>

label_lower

模型的表示,返回<span>app_label.model_name</span>,例如<span>'polls.Question'</span>

相关推荐