Django4 中文入门教程 Django4.0 模型-方法

2024-02-25 开发教程 Django4 中文入门教程 匿名 6

在模型中添加自定义方法会给你的对象提供自定义的“行级”操作能力。与之对应的是类 ​​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 语句。