Django中文文档-模型Models（二）：Meta选项、模型属性、模型方法

阅读原文时间：2023年07月11日阅读：1

使用内部的class Meta 定义模型的元数据，例如：

from django.db import models

class Ox(models.Model):
horn_length = models.IntegerField()

class Meta:  
    ordering = \["horn\_length"\]  
    verbose\_name\_plural = "oxen"

模型元数据是“任何不是字段的数据”，比如排序选项（ordering），数据库表名（db_table）或者人类可读的单复数名称（verbose_name 和verbose_name_plural）。在模型中添加class Meta是完全可选，所有选项都不是必须的。

所有元选项的完整列表可以在模型选项参考找到。

objects

模型最重要的属性是Manager。它是Django 模型进行数据库查询操作的接口，并用于从数据库获取实例。如果没有自定义Manager，则默认的名称为objects。Managers 只能通过模型类访问，而不能通过模型实例访问。

可以在模型上自定义方法来给你的对象添加自定义的“底层”功能。相对于Manager 方法用于“表范围”的事务，模型方法则着眼于特定的模型实例。

这是一项非常有价值的技术，让业务逻辑位于同一个地方 —— 模型中。

例如，下面的模型具有一些自定义的方法：

from django.db import models

class Person(models.Model):
first_name = models.CharField(max_length=50)
last_name = models.CharField(max_length=50)
birth_date = models.DateField()

def baby\_boomer\_status(self):  
    "Returns the person's baby-boomer status."  
    import datetime  
    if self.birth\_date < datetime.date(1945, 8, 1):  
        return "Pre-boomer"  
    elif self.birth\_date < datetime.date(1965, 1, 1):  
        return "Baby boomer"  
    else:  
        return "Post-boomer"

def \_get\_full\_name(self):  
    "Returns the person's full name."  
    return '%s %s' % (self.first\_name, self.last\_name)  
full\_name = property(\_get\_full\_name)

这个例子中的最后一个方法是一个属性。

模型实例参考中有每个模型自带方法的完整列表。它们大部分都可以被覆盖 —— 参见下文覆盖模型预定义的方法 —— 但是有些方法你会始终想要定义：

str() (Python 3)　　

一个Python的魔术方法（magic method)，返回对象的字符串表达式(unicode格式）当模型实例需要强制转换并显示为普通的字符串时，Python 和Django 将使用这个方法。最突出的用法是在交互式控制台或者管理站点显示一个对象。

你会经常需要定义这个方法；默认方法返回的内容没多大用处。

unicode() (Python 2)

Python 2中等同于 __str__().

get_absolute_url()

它告诉Django 如何计算一个对象的URL。Django 在它的管理站点中使用到这个方法，在其它任何需要计算一个对象的URL 时也将用到。

任何具有唯一标识自己的URL 的对象都应该定义这个方法。

重写预定义的模型方法

还有另外一部分封装数据库行为的模型方法，我们有时可能也需要自定义它们。尤其是save() 和delete() 的工作方式。

你可以自由覆盖这些方法（和其它任何模型方法）来改变它们的行为。

覆盖内建模型方法的一个典型的使用场景是，你想在保存一个对象时做一些其它事情。例如（参见save() 中关于它接收的参数的文档）：

from django.db import models

class Blog(models.Model):
name = models.CharField(max_length=100)
tagline = models.TextField()

def save(self, \*args, \*\*kwargs):  
    do\_something()  
    super(Blog, self).save(\*args, \*\*kwargs) # Call the "real" save() method.  
    do\_something\_else()

你还可以阻止保存：

from django.db import models

class Blog(models.Model):
name = models.CharField(max_length=100)
tagline = models.TextField()

def save(self, \*args, \*\*kwargs):  
    if self.name == "Yoko Ono's blog":  
        return # Yoko shall never have her own blog!  
    else:  
        super(Blog, self).save(\*args, \*\*kwargs) # Call the "real" save() method.

必须要记住调用超类的方法—— super(Blog, self).save(*args, **kwargs) —— 来确保对象被保存到数据库中。如果你忘记调用超类的这个方法，默认的行为将不会实行并且数据库不会有任何改变。

还要记住传递参数给这个模型方法 —— 即*args, **kwargs。 Django 未来将一直会扩展内建模型方法的功能并添加新的参数。如果在你的方法定义中使用*args, **kwargs，将保证你的代码自动支持这些新的参数。

注意：

批量操作中被覆盖的模型方法不会被调用

注意，当使用查询集批量删除对象时，将不会为每个对象调用delete() 方法。为确保自定义的删除逻辑得到执行，你可以使用pre_delete 和/或post_delete 信号。

不幸的是，当批量creating 或updating 对象时没有变通方法，因为不会调用save()、pre_save和 post_save。