【后端】【django】【进阶】自定义管理器——封装常用查询

1. 自定义管理器的作用

Django 的 models.Manager 允许自定义查询逻辑,让你更方便地封装常用查询,提高代码复用性。

在你的示例中:

  • objects = models.Manager() 是 Django 默认的管理器,返回所有数据。
  • published = PublishedManager() 是自定义的管理器,只返回已发布的文章 (is_published=True)。
  • 这样可以通过 Article.published.all() 快速获取已发布的文章,而不影响 Article.objects.all() 返回所有文章。

2. 代码解析

python 复制代码
class PublishedManager(models.Manager):
    def get_queryset(self):
        return super().get_queryset().filter(is_published=True)

(1)get_queryset() 方法

  • 作用 :重写 get_queryset(),修改默认查询集(QuerySet)。
  • 原理 :super().get_queryset() 获取原始 QuerySet,然后 .filter(is_published=True) 让它只返回 is_published=True 的数据。

3. 使用示例

python 复制代码
# 创建文章
Article.objects.create(title="草稿文章", content="这是一篇草稿", is_published=False)
Article.objects.create(title="已发布文章", content="这是一篇已发布的文章", is_published=True)

# 查询所有文章
print(Article.objects.all())  
# 输出: <QuerySet [<Article: 草稿文章>, <Article: 已发布文章>]>

# 只查询已发布的文章
print(Article.published.all())  
# 输出: <QuerySet [<Article: 已发布文章>]>
  • Article.objects.all() 返回所有文章。
  • Article.published.all() 自动过滤掉未发布的文章。

4. 其他常见用法

(1)添加自定义方法

可以在 PublishedManager 里添加更多自定义方法,比如查询最近发布的文章:

python 复制代码
class PublishedManager(models.Manager):
    def get_queryset(self):
        return super().get_queryset().filter(is_published=True)

    def recent(self, days=7):
        from django.utils.timezone import now
        return self.get_queryset().filter(created_at__gte=now() - timedelta(days=days))

class Article(models.Model):
    title = models.CharField(max_length=100)
    content = models.TextField()
    is_published = models.BooleanField(default=False)
    created_at = models.DateTimeField(auto_now_add=True)

    objects = models.Manager()  # 默认管理器
    published = PublishedManager()  # 只返回已发布的文章
使用方法
python 复制代码
# 查询最近 7 天发布的文章
Article.published.recent()

(2)防止 objects 被覆盖

如果 objects 只使用 PublishedManager,就无法查询未发布的文章:

python 复制代码
class Article(models.Model):
    title = models.CharField(max_length=100)
    content = models.TextField()
    is_published = models.BooleanField(default=False)

    objects = PublishedManager()  # 这样 `objects.all()` 也只返回已发布的文章

如果要查询所有文章(包括未发布的),最好保留 objects = models.Manager(),这样:

  • Article.objects.all() 获取所有文章
  • Article.published.all() 只获取已发布的文章

5. 总结

功能 默认管理器 objects 自定义管理器 published
返回所有数据 ✅ Article.objects.all() ❌
只返回已发布数据 ❌ ✅ Article.published.all()
可以扩展更多方法 ❌ ✅ Article.published.recent()

💡 适用于哪些场景?

  • 需要频繁筛选某些特定数据(如已发布文章、活跃用户)。
  • 让查询更语义化 ,避免重复 filter()。
  • 避免 objects 被污染,保留所有数据的访问能力。
相关推荐
Decay__1 小时前
PostgreSQL 数据库全栈运维实战系列 — 合集索引(24 篇)
运维·数据库·sql·mysql·架构
琳少_6 小时前
java程序开发笔记
java·开发语言·数据库·笔记
Pocker_Spades_A9 小时前
工业物联网时序数据库选型:一份能直接抄走的技术规格书
数据库·物联网·时序数据库
苜蓿muxu9 小时前
缓存三大问题:穿透、击穿、雪崩
数据库·redis
正在走向自律10 小时前
MySQL兼容性深度实践:建表、增删改查与迁移避坑全记录
数据库·sql·mysql·信创·数据库迁移
JonaHu10 小时前
关键词排名突然消失?用 Python、SQLite 和 SERP API 搭一套可解释的 SEO 监控
python·sqlite·seo·serp api
隔窗听雨眠11 小时前
openGauss开源五年的内核演进与生态工程
数据库·opengauss·国产数据库
Decay__11 小时前
PostgreSQL 体系架构全解 —— 进程模型、共享内存、MVCC 与 WAL 预写日志深入
运维·数据库·sql·mysql·架构
沐知全栈开发13 小时前
基于ClinicalTrials公开数据的临床试验分析系统-毕业设计
数据库·课程设计
半杯咖啡半行码13 小时前
Qt 隐式共享(Implicit Sharing)深度解析:机制、陷阱与 Qt6迁移
开发语言·数据库·qt