Django4.0 模型-方法
在模型中添加自定义方法会给你的对象提供自定义的“行级”操作能力。与之对应的是类 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"
@property
def full_name(self):
"Returns the person's full name."
return '%s %s' % (self.first_name, self.last_name)
-
__str__()
:返回值展示了一个对象。Python 和 Django 在要将模型实例展示为纯文本时调用。最有可能的应用场景是交互式控制台或后台。你将会经常定义此方法;默认提供的不是很好用。 -
get_absolute_url()
:该方法告诉 Django 如何计算一个对象的 URL。Django 在后台接口使用此方法,或任意时间它需要计算一个对象的 URL。任何需要一个唯一 URL 的对象需要定义此方法。
重写之前定义的模型方法
还有一个 模型方法 的集合,包含了一些你可能自定义的数据库行为。尤其是这两个你最有可能定制的方法 save()
和 delete()
。你可以随意地重写这些方法(或其它模型方法)来更改方法的行为。一个典型的重写内置方法的场景是你想在保存对象时额外做些事。
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().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().save(*args, **kwargs) # Call the "real" save() method.
调用父类的方法非常重要——这里指 super().save(*args, **kwargs)
——确保对象正确的写入数据库。若你忘记调用父类方法,默认行为不会被触发,数据库也不会被操作。同时传递模型方法接受的参数也很重要—— *args
, **kwargs
会接受这些参数。Django 会不时地扩展模型内置方法的功能,也会添加新参数。如果你在重写的方法中使用了 *args
, **kwargs
,这将确保你的方法能接受这些新加的参数。
注意:
重写的模型方法不会在批量操作中调用。
删除一个模型对象不总是要调用 delete()
方法。例如,使用 QuerySet
批量删除对象 <topics-db-queries-delete>
和 级联删除。为了确保自定义的删除逻辑被执行,你可以使用 pre_delete
和 post_delete
信号。不幸的是,批量 creating
和 updating
操作不支持上述操作,因为这两种操作未调用 save()
,pre_save
和 post_save
。
执行自定义SQL
另一个常见的模式是在模型方法和模块方法中编写自定义 SQL 语句。