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

模型方法 (Model Methods)

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


(一)示例代码解析

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%)

(二)模型方法的作用

方法 作用 示例调用
is_paid() 判断订单是否已支付 order.is_paid()
mark_as_paid() 将订单标记为已支付并保存 order.mark_as_paid()
calculate_tax(tax_rate) 计算订单的税额 order.calculate_tax(0.15)

(三)模型方法的实际使用

1. 判断订单是否已支付

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

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


2. 标记订单为已支付

python 复制代码
order.mark_as_paid()
print(order.status)  # 输出: 'paid'
  • self.save(update_fields=['status']) 只更新 status 字段 ,比 save() 效率更高,减少数据库开销。

3. 计算订单的税额

python 复制代码
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. 自定义管理器

对比项 模型方法 (Model Methods) 自定义管理器 (Model Manager)
作用 针对单个对象的操作 查询集 (QuerySet) 级别的操作
调用方式 order.is_paid() Order.paid_orders.all()
适用场景 业务逻辑封装,如状态变更、计算 需要封装一类特定查询时
  • 模型方法适用于 需要对单个实例 (对象)执行的操作,如 is_paid()mark_as_paid()
  • 自定义管理器适用于 查询集级别的操作 ,如 Order.published.all()

💡 最佳实践

可以结合 自定义管理器模型方法

python 复制代码
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 项目的业务逻辑封装,提高代码可读性和复用性!

相关推荐
2301_779503761 小时前
MySQL主从同步--主从复制进阶
数据库·mysql
beijingliushao1 小时前
58-正则表达式
数据库·python·mysql·正则表达式
诗句藏于尽头2 小时前
DJANGO后端服务启动报错及解决
数据库·笔记·django
手握风云-2 小时前
MySQL数据库精研之旅第十五期:索引的 “潜规则”(下)
数据库
失散133 小时前
分布式专题——1.1 Redis单机、主从、哨兵、集群部署
java·数据库·redis·分布式·架构
2301_779503763 小时前
MySQL集群高可用架构---mysql高可用之组复制 (MGR)
数据库·mysql·架构
Hello.Reader3 小时前
一文通关 Proto3完整语法与工程实践
java·linux·数据库·proto3
c萱4 小时前
软件测试错题笔记
软件测试·数据库·笔记·测试工具·oracle·测试用例
長琹4 小时前
AES加密算法详细加密步骤代码实现--身份证号码加解密系统
网络·数据库·人工智能·python·密码学
言之。4 小时前
Django REST framework:SimpleRouter 使用指南
python·django·sqlite