【后端】【djanog】【进阶】【models】自定义模型方法 (`Model Methods`)——封装业务逻辑

模型方法 (Model Methods)

Django 的 模型方法 是 models.Model 类中的普通 Python 方法，主要用于 封装业务逻辑，让代码更加清晰、可复用。

（一）示例代码解析

class Order(models.Model):
    total_amount = models.DecimalField(max_digits=10, decimal_places=2)  # 订单总金额
    status = models.CharField(max_length=20, default='pending')  # 订单状态

    def is_paid(self):
        return self.status == 'paid'  # 判断订单是否已支付

    def mark_as_paid(self):
        self.status = 'paid'
        self.save(update_fields=['status'])  # 只更新 `status` 字段，提高效率

    def calculate_tax(self, tax_rate=0.1):
        return self.total_amount * tax_rate  # 计算税额（默认 10%）

（二）模型方法的作用

（三）模型方法的实际使用

1. 判断订单是否已支付

order = Order.objects.get(id=1)
if order.is_paid():
    print("订单已支付")
else:
    print("订单未支付")

这样比直接写 if order.status == 'paid': 更清晰，可读性更强。

2. 标记订单为已支付

order.mark_as_paid()
print(order.status)  # 输出: 'paid'

• self.save(update_fields=['status']) 只更新 status 字段，比 save() 效率更高，减少数据库开销。

3. 计算订单的税额

order = Order.objects.get(id=1)
tax = order.calculate_tax()  # 默认 10% 税率
tax_custom = order.calculate_tax(0.15)  # 自定义 15% 税率
print(f"税额: {tax}, 自定义税额: {tax_custom}")

（四）模型方法 vs. 自定义管理器

• 模型方法适用于 需要对单个实例（对象）执行的操作，如 is_paid()、mark_as_paid()。
• 自定义管理器适用于 查询集级别的操作，如 Order.published.all()。

💡 最佳实践
可以结合 自定义管理器 和 模型方法：

class OrderManager(models.Manager):
    def paid_orders(self):
        return self.filter(status='paid')

class Order(models.Model):
    total_amount = models.DecimalField(max_digits=10, decimal_places=2)
    status = models.CharField(max_length=20, default='pending')

    objects = models.Manager()  # 默认管理器
    paid = OrderManager()  # 自定义管理器，只查询已支付订单

    def is_paid(self):
        return self.status == 'paid'

    def mark_as_paid(self):
        self.status = 'paid'
        self.save(update_fields=['status'])

    def calculate_tax(self, tax_rate=0.1):
        return self.total_amount * tax_rate

这样：

• Order.paid.all() 查询所有已支付订单（适用于批量查询）。
• order.is_paid() 判断单个订单是否已支付。

（五）总结

1. 模型方法 用于单个实例的操作，如状态判断、修改、计算等。
2. save(update_fields=['status']) 提高数据库更新效率，避免 save() 更新所有字段。
3. 结合自定义管理器，可以让查询和业务逻辑更加清晰：
   • 模型方法 处理单个对象的逻辑（如 is_paid()）。
   • 管理器 处理查询集的逻辑（如 Order.paid.all()）。

🚀 适用于 Django 项目的业务逻辑封装，提高代码可读性和复用性！