元数据(Meta)选项
使用内部的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。
执行自定义的SQL
另外一个常见的需求是在模型方法和模块级别的方法中编写自定义的SQL 语句。关于使用原始SQL 语句的更多细节,参见使用原始 SQL的文档。