Question

我已经阅读了官方Django documentation中的定义，并且仍然对Manager的作用感到困惑。

文档说它们允许您操作数据库表/模型。但我仍然不明白这一点。

有人可以向我解释经理及其角色吗？一个例子的答案是可取的。

Answer 1

管理员通常是远离django程序员的东西，django使用它来连接model代码和数据库后端。

当您查询django ORM时，您可以通过调用

来执行此操作

from my_app.models import MyModel

mms = MyModel.objects.all()

在这种情况下，函数的objects部分是经理返回的部分。如果您希望MyModel只获得blue MyModel个实例（数据库也可能包含red个模型），那么您可以创建一个管理器并破解您的模型

class BlueManager(models.Manager):
    def get_query_set(self):
        return super(BlueManager, self).get_query_set().filter(colour='Blue')

class MyModel(models.Model):
     colour = models.CharField(max_length=64)
     blue_objects = BlueManager()

并致电

MyModel.blue_objects.all()

只返回colour为blue的对象。请注意，这是一种过滤模型的非常差的方法！

如果要修改管理员通常会返回的Manager或者您需要添加“表”级查询（而不是常规查询），通常需要修改QuerySet接口django“排”级别）。管理者的documentation非常完整，包含几个例子。

Answer 2

Manager是应用程序和数据库之间的某种“门”。一件好事是你可以为模型定义自己的基本查询集。例如：如果您的模型“预订”带有“可用性”字段，则可以准备自己的查询集，该查询集筛选特定的可用性类型之王：

models.py：

class AvailableBookManager(models.Manager):
    def get_query_set(self):
        return super(AvailableBookManager, self).get_query_set().filter(availability=1)

class Book(models.Model):
   (...)#fields definition

   objects = models.Manager() #default manager
   available_objects = AvailableBookManager() #own manager

现在你可以使用：

books = Book.available_objects.all()

不是：

books = Book.objects.filter(available=1)

Answer 3

定义

从文档中

管理器是Django类，提供了数据库查询操作和Django模型之间的接口。

换句话说，在Django模型中，管理器是与数据库交互的接口。例如，当您想从数据库中检索对象时，需要通过模型类上的QuerySet来构建Manager。

默认情况下，可以通过Model.objects属性使用管理器。该经理是django.db.models.Manager。但是，扩展它并更改默认管理器非常简单。

自定义经理

来自the docs：

您可以通过扩展基本Manager类并在模型中实例化自定义Manager来在特定模型中使用自定义Manager。

您可能要自定义Manager的原因有两个（没有一个是排他的）：

添加其他Manager方法
修改管理器返回的初始QuerySet

示例：向Manager添加其他方法

from django.db import models

class DocumentManager(models.Manager):
    def pdfs(self):
        return self.filter(file_type='pdf')

    def smaller_than(self, size):
        return self.filter(size__lt=size)


class Document(models.Model):
    name = models.CharField(max_length=30)
    size = models.PositiveIntegerField(default=0)
    file_type = models.CharField(max_length=10, blank=True)

    objects = DocumentManager()

    def __str__(self) -> str:
        return self.name

示例：修改管理器返回的初始QuerySet

from django.db import models


class AuthorManager(models.Manager):
    def get_queryset(self):
        return super().get_queryset().filter(first_name__startswith='M')

class Author(models.Model):
    first_name = models.CharField(max_length=100)
    last_name = models.CharField(max_length=100)
    email = models.EmailField()

    objects = AuthorManager()

    def __str__(self) -> str:
        return f"{self.first_name} {self.last_name}"

示例：同时有多个经理

同一模型可能有多个经理。

from django.db import models
from django.db.models.functions import Length

class BookTitleManager(models.Manager):
    def short_titles(self):
        return self.annotate(length=Length('title')).filter(length__lte=20)

    def long_titles(self):
        return self.annotate(length=Length('title')).filter(length__gt=20, length__lte=30)
    
    def very_long_titles(self):
        return self.annotate(length=Length('title')).filter(length__gt=30)

    def starts_with(self, letter):
        return self.filter(title__startswith=letter)


class BookPagesManager(models.Manager):
    def small_books(self):
        return self.filter(pages__lt=200)
    
    def medium_books(self):
        return self.filter(pages__gte=200, pages__lt=300)
    
    def large_books(self):
        return self.filter(pages__gte=300, pages__lte=500)


class Book(models.Model):
    title = models.CharField(max_length=255)
    author = models.CharField(max_length=255)
    pages = models.IntegerField()

    objects = models.Manager()
    titles = BookTitleManager()
    sizes = BookPagesManager()

    def __str__(self) -> str:
        return f'{self.title} by {self.author}'

在先前的代码示例中，有3个管理器：默认的models.Manager，BookTitleManager和BookPagesManager分配给objects，titles和{{1 }}。

以前的经理所遇到的问题是，您无法按以下方式链接他们：

sizes

示例：自定义管理器和查询集（允许使用链）

如果要链接在管理器中定义的方法，则应按以下方式定义自定义QuerySet：

>>> Book.titles.long_titles().starts_with('P')
AttributeError: 'QuerySet' object has no attribute 'starts_with'

示例：用作管理器的自定义查询集

在管理器中仅定义自定义from django.db import models from django.db.models.functions import Length class AuthorQuerySet(models.QuerySet): def long_first_name(self): return self.annotate(length=Length("first_name")).filter(length__gte=10) def short_last_name(self): return self.annotate(length=Length("last_name")).filter(length__lte=10) class AuthorManager(models.Manager): def get_queryset(self): return AuthorQuerySet(self.model, using=self._db) def long_first_name(self): return self.get_queryset().long_first_name() def short_last_name(self): return self.get_queryset().short_last_name() class Author(models.Model): first_name = models.CharField(max_length=100) last_name = models.CharField(max_length=100) email = models.EmailField() objects = AuthorManager() def __str__(self) -> str: return f"{self.first_name} {self.last_name}"时，可以简单地扩展QuerySets并将其设置为管理器。

QuerySet

也要记住

如果要使用from django.db import models from django.db.models.functions import Length class PublisherQuerySet(models.QuerySet): def long_name(self): return self.annotate(length=Length("name")).filter(length__gte=15) def long_address(self): return self.annotate(length=Length("address")).filter(length__gte=25) def country_starts_with(self, letter): return self.filter(country__startswith=letter) class Publisher(models.Model): name = models.CharField(max_length=100) address = models.CharField(max_length=255) country = models.CharField(max_length=100) objects = PublisherQuerySet.as_manager() # uses QuerySet as Manager def __str__(self) -> str: return self.name作为字段名称，或者要为Manager使用objects以外的名称，则可以按模型重命名。要为给定类重命名Manager，请在该模型上定义类型为models.Manager（）的类属性。

objects

在先前的代码示例中，调用class Document(models.Model): name = models.CharField(max_length=30) size = models.PositiveIntegerField(default=0) file_type = models.CharField(max_length=10, blank=True) stuff = models.Manager() def __str__(self) -> str: return self.name会生成Document.objects异常，因为默认管理器已被重命名，现在可以使用的是AttributeError。

只能通过模型类而不是模型实例访问管理器，以实现“表级”操作和“记录级”操作之间的分隔。
如果模型具有ForeignKey，则外键模型的实例将有权访问Manager，该Manager返回第一个模型的所有实例。默认情况下，该管理器的名称为Document.stuff，其中FOO_set是源模型名称，小写。

什么是django的“经理”？

3 个答案:

定义