Django Model Meta options

作者: 罗田 | 来源:发表于2014-12-12 11:23 被阅读1229次

    Django Model Meta options

    Django版本:1.7
    主要来源:https://docs.djangoproject.com/en/1.7/ref/models/options/

    定义方式:

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

    1、abstract

    如果设置abstract=True则这个模式是一个抽象基类

    2、app_label

    如果一个 model 定义在默认的 models.py 之外 (例如,如果你的 app 的 models 在 myapp.models 子模块下),你必须定义 app_label 让 Django 知道它属于哪一个 app

    在django1.7中不再需要使用app_label来定议

    3、db_table

    定义model在数据库中的表名称

    db_table = 'music_album'
    

    Django默认通过app名称+_+model的类名生成数据表

    例如,如果你有一个 app 叫做 bookstore (使用 manage.py startapp bookstore 创建),以 及一个 model 定义为 class Book 这样将会创建一个名为 bookstore_book 的数据库表。

    如果你的数据库表名称是一个SQL保留字,或者它包含不允许出现在 Python 变量中的字符 (比如-字符)这是没问题的。这是因为 Django 会自动给列名和表名添加引号。

    数据库为Mysql时db_table应该使用小写

    数据库为oracle时为了适应oracle的30字符限制和匹配ORACLE的惯例,Django可能缩短表名,并把他们全部大写,为了防止这种转换,使用带引号的名称作为db_table值:

    db_table ='“name_left_in_lowercase”'

    4、db_tablespace

    设置数据库表空间,默认是DEFAULT_TABLESPACE。Django不会去创建或生成表空间,仅仅是使用,如果数据库使用不支持表空间,这个选项会被忽略。

    5、get_latest_by

    用于指定默认的排序字段,支持DateField\DateTimeField\IntegerField

    get_latest_by =“ORDER_DATE”
    

    6、managed

    默认值为True,这个选项为True时Django可以对数据库表进行 migrate或migrations、删除等操作。在这个时间Django将管理数据库中表的生命周期

    如果为False的时候,不会对数据库表进行创建、删除等操作。可以用于现有表、数据库视图等,其他操作是一样的。包括:

    如果没有声明主键字段,Django 将自动的为 model 增加一个自增的主键字段。当你使用不被* 管理* 的 models 时,为了避免让将来阅读代码的人迷惑,建议指明所有所有托管在 model 中的字 段与数据库表的关系。

    如果两个非托管的 models (managed=False) 之间,使用了 ManyToManyField 关联,就不会创建多对多关系的中间表。然而 如果是一个托管的 model 与另一个非托管的 model 的话,多对多关系 将会 被创建。

    如果你需要改变默认的行为,就的显示的定义中间 model 来在数据库中创建中间表(要将 managed 设置为 True),然后在你的原 model 上使用 ManyToManyField.through 属性指向中间 model,就能实现自定义的多对多关系。

    如果你的测试中包含非托管 model (managed=False),那么在测试之前,你应该要确保在测试 创建时已经创建了正确的数据表。

    7、order_with_respect_to

    根据给定的字段对 model 排序。在关联关系中,它经常用在根据目标对象对源对象排序的场合。举 个例子,一个 Answer 只关联一个 Question 对象,而一个 question 对象却可以关联多 个 answer 对象。根据 question 对 answer 排序,你应该这么做:

    class Answer(models.Model):
        question = models.ForeignKey(Question)
        # ...
    
        class Meta:
            order_with_respect_to = 'question'
    

    当 order_with_respect_to 被设置时,会提供两个附加的方法用于获取和设置关联对象的排序: get_RELATED_order() 和 set_RELATED_order() ,这其中的 RELATED 是 model 的小 写名字。例如,假定一个 Question 对象关联到多个 Answer 对象,这将返回一个包含 Answer 对象主键的列表:

    >>> question = Question.objects.get(id=1)
    >>> question.get_answer_order()
    [1, 2, 3]
    

    可以通过传入一个 Answer 主键的列表的方式来设置 Question 对象关联的 Answer 对象的顺序:

    >>> question.set_answer_order([3, 1, 2])
    

    关联的对象同样有两个方法, get_next_in_order() 和 get_previous_in_order() , 可 以用来访问那些特定的对象。假定 Answer 对象是以 id 排序的:

    >>> answer = Answer.objects.get(id=2)
    >>> answer.get_next_in_order()
    <Answer: 3>
    >>> answer.get_previous_in_order()
    <Answer: 1>
    

    改变 order_with_respect_to 时注意
    order_with_respect_to 增加了一个名为 _order 的字段(数据库字段),因此在你进 行 syncdb 操作后,如果你增加或者改变了 order_with_respect_to 需运行 migrate来保证变更。

    8、ordering

    定义默认的排序列:

    ordering = ['-order_date']
    

    如果在字段前加"-"表示降序排列,不加则是升序排列。加?随机排列

    可以综合排列:

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

    增加排序会影响数据库性能,外键也会包含相应排序

    9、permissions

    在创建对象时,添加到权限表当中的附加权限信息。Django 自动为每个设置了 admin 的对象创建了添 加,删除和修改的权限。下面这个例子展示了如何添加一个附加的权限 can_deliver_pizzas:

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

    该项可以是一个列表或一个由两个元组构成的元组,以这样的格式
    (permission_code, human_readable_permission_name) 。

    10、default_permissions

    默认包含('add','change','delete'),你也可自定义权限列表,例如:如果应用程序不需要任何的默认权限,就可以把这个选项设为空列表。为避免权限的遗漏这个选项必须在model生成之前定义。

    11、proxy

    如果 proxy = True ,表示该 model 是其父类的代理

    12、select_on_save

    默认值是False,用于决定是否启用django.db.models.Model.save()算法,这个新算法会尝试直接Update,但在一些罕见的情况下,是有问题的,例如PostgreSQL的ON Update触发器返回NULL,在这种情况下,新算法会不管数据是否存在,而执行Insert操作。

    13、unique_together

    用来设置的不重复的字段组合,必须唯一(将两个字段做联合唯一):

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

    它是一个字段名称的列表,列表内的字段组合在数据库中是唯一,不重复的,也就是说不可以有两 个对象,它们在列表中的字段值是完全相同的。它被用在 Django admin 后台,在数据库层级约束 数据。(比如,在 CREATE TABLE 语句中包含 UNIQUE 关键字)

    为了使用方便,你可以赋给该项一个单独的字段列表的元组:

    unique_together = ("driver", "restaurant")
    

    一个 ManyToManyField 不能包含在 unique_together 中。 (这 将会导致它看起来不明不白!) 如果你需要验证关联到 ManyToManyField 字段的唯一性验证,尝试使用 signal(信号) 或者 明确指定 model 的 through 属性。

    在验证出错误时会返回unique_together错误

    14、index_together

    通过字段名集合创建索引:

    index_together = [
        ["pub_date", "deadline"],
    ]
    

    会根据选项生成合适的CREATE INDEX语句

    也可以使用便利的写法:

    index_together = ["pub_date", "deadline"]
    

    15、verbose_name

    指定该对象的一个可读性更好的唯一名字(单数):

    verbose_name = "pizza"
    

    如果没有指定这个选项,会将以驼峰命名的CamelCase转换为camel case

    16、verbose_name_plural

    指定该对象的一个可读性更好的唯一名字(复数):

    verbose_name_plural = "stories"
    

    默认是verbose_name+"s"

    相关文章

      网友评论

        本文标题:Django Model Meta options

        本文链接:https://www.haomeiwen.com/subject/puwntttx.html