本文首发于微信公众号：Hunter后端
原文链接：Django笔记十九之manager用法介绍

首先介绍一下 manager 的使用场景，比如我们有一些表级别的，需要重复使用的功能，都可以使用 manager 来实现。

比如我们在前面的笔记中介绍的 model 的 create()、update() 等方法，Blog.objects.create() 中前面的 objects 就是一种 manager，不过这是系统给我们定义的。

那么我们也可以自己通过 manager 的方式来定义一些通用的函数方便我们在系统中使用。

  1. 定义 manager
  2. 使用 manager
  3. 通过 manager 更改原始的 QuerySet

1、定义 manager

定义的方式为创建一个继承 models.Manager 的类，定义所需要的函数，然后在 model 里定义 objects 指向这个 Manager 即可：

class BlogManager(modls.Manager):
	def test_func(self, *args, **kwargs):
		# 执行一些操作
		return 

class Blog(models.Model):
	
	objects = BlogManager()

2、使用 manager

假设我们想实现这样一个功能，通过输入一个 keyword，返回所有 name 字段包含 keyword 的数据的总数。

不使用 manager 的话，我们大概每次都会这样来操作：

keyword = "python"
count = Blog.objects.filter(name__icontains=keyword)

如果是使用 manager 来实现，则可以先定义这个函数：

class BlogManager(models.Manager):
    def contain_keyword_count(self, keyword):
        return self.filter(name__icontains=keyword).count()


class Blog(models.Model):
    name = models.CharField(max_length=100)
    tagline = models.TextField()

    objects = BlogManager()

那么通过 Manager 来操作便是：

keyword = "python"
count = Blog.objects.contain_keyword_count(keyword)

注意，这里指向 BlogManager 的变量，我们与系统默认的 objects 保持了一致，我们可以定义为其他名称，不过调用的时候，需要改成其他的形式即可，比如：


class Blog(models.Model):
    name = models.CharField(max_length=100)
    tagline = models.TextField()

    blog_objects = BlogManager

Blog.blog_objects.contain_keyword_count(keyword)

3、通过 manager 更改原始的 QuerySet

有一些底层的 QuerySet 的函数我们也可以通过 manager 的形式来继承修改，比如 get_queryset()，其他的比如 filter()、exclude()、all() 在底层都会调用这个函数。

现在我们来通过 manager 改写这个函数：

class BlogManager(models.Manager):
	def get_queryset(self):
		return super().get_queryset().filter(name__icontains="python")


class Blog(models.Model):
    name = models.CharField(max_length=100)
    tagline = models.TextField()


    objects = models.Manager()
    blog_objects = BlogManager()

然后当我们调用下面的：

Blog.objects.all()
Blog.blog_objects.all()

则会是两个结果，第一个返回的是原始的 all() 的结果，第二条则是我们定义了经过筛选的结果。

注意：blog_objects 和原来的 objects 一样，可以在原来的基础上进行其他的筛选操作，比如：

Blog.blog_objects.filter(tagline='xxx')

以上只是简单介绍了 manager 的使用方法，我们可以往 manager 的函数里添加更多复杂的功能函数，这个可以根据需要添加。

以上就是本篇笔记的全部内容，下一篇笔记我们将介绍 migration 的命令和手动增加 migration 文件。

如果想获取更多相关文章，可扫码关注阅读：
image