详解python的django框架中manager方法的使用

在语句book.objects.all()中,objects是一个特殊的属性,需要通过它查询数据库。 在第5章,我们只是简要地说这是模块的manager 。现在是时候深入了解managers是什么和如何使用了。

总之,模块manager是一个对象,django模块通过它进行数据库查询。 每个django模块至少有一个manager,你可以创建自定义manager以定制数据库访问。

下面是你创建自定义manager的两个原因: 增加额外的manager方法,和/或修manager返回的初始queryset。
增加额外的manager方法

增加额外的manager方法是为模块添加表级功能的首选办法。

例如,我们为book模型定义了一个title_count()方法,它需要一个关键字,返回包含这个关键字的书的数量。 (这个例子有点牵强,不过它可以说明managers如何工作。)

# models.py
from django.db import models
# … author and publisher models here …
**class bookmanager(models.manager):**
**def title_count(self, keyword):**
**return self.filter(title__icontains=keyword).count()**
class book(models.model):
title = models.charfield(max_length=100)
authors = models.manytomanyfield(author)
publisher = models.foreignkey(publisher)
publication_date = models.datefield()
num_pages = models.integerfield(blank=true, null=true)
**objects = bookmanager()**
def __unicode__(self):
return self.title

有了这个manager,我们现在可以这样做:

>>> book.objects.title_count(‘django’)
4
>>> book.objects.title_count(‘python’)
18

下面是编码该注意的一些地方:

我们建立了一个bookmanager类,它继承了django.db.models.manager。这个类只有一个title_count()方法,用来做统计。 注意,这个方法使用了self.filter(),此处self指manager本身。
我们把bookmanager()赋值给模型的objects属性。 它将取代模型的默认manager(objects)如果我们没有特别定义,它将会被自动创建。 我们把它命名为objects,这是为了与自动创建的manager保持一致。

为什么我们要添加一个title_count()方法呢?是为了将经常使用的查询进行封装,这样我们就不必重复编码了。
修改初始manager querysets

manager的基本queryset返回系统中的所有对象。 例如,“ book.objects.all()“ 返回数据库book中的所有书本。

我们可以通过覆盖manager.get_query_set()方法来重写manager的基本queryset。 get_query_set()按照你的要求返回一个queryset。

例如,下面的模型有* 两个* manager。一个返回所有对像,另一个只返回作者是roald dahl的书。

from django.db import models
**# first, define the manager subclass.**
**class dahlbookmanager(models.manager):**
**def get_query_set(self):**
**return super(dahlbookmanager, self).get_query_set().filter(author=’roald dahl’)**
**# then hook it into the book model explicitly.**
class book(models.model):
title = models.charfield(max_length=100)
author = models.charfield(max_length=50)
# …
**objects = models.manager() # the default manager.**
**dahl_objects = dahlbookmanager() # the dahl-specific manager.**

在这个示例模型中,book.objects.all()返回了数据库中的所有书本,而book.dahl_objects.all()只返回了一本. 注意我们明确地将objects设置成manager的实例,因为如果我们不这么做,那么唯一可用的manager就将是dah1_objects。

当然,由于get_query_set()返回的是一个queryset对象,所以我们可以使用filter(),exclude()和其他一切queryset的方法。 像这些语法都是正确的:

book.dahl_objects.all()
book.dahl_objects.filter(title=’matilda’)
book.dahl_objects.count()

这个例子也指出了其他有趣的技术: 在同一个模型中使用多个manager。 只要你愿意,你可以为你的模型添加多个manager()实例。 这是一个为模型添加通用滤器的简单方法。

例如:

class malemanager(models.manager):
def get_query_set(self):
return super(malemanager, self).get_query_set().filter(sex=’m’)
class femalemanager(models.manager):
def get_query_set(self):
return super(femalemanager, self).get_query_set().filter(sex=’f’)
class person(models.model):
first_name = models.charfield(max_length=50)
last_name = models.charfield(max_length=50)
sex = models.charfield(max_length=1, choices=((‘m’, ‘male’), (‘f’, ‘female’)))
people = models.manager()
men = malemanager()
women = femalemanager()

这个例子允许你执行“ person.men.all()“ ,“ person.women.all()“ ,“ person.people.all()“ 查询,生成你想要的结果。

如果你使用自定义的manager对象,请注意,django遇到的第一个manager(以它在模型中被定义的位置为准)会有一个特殊状态。 django将会把第一个manager 定义为默认manager ,django的许多部分(但是不包括admin应用)将会明确地为模型使用这个manager。 结论是,你应该小心地选择你的默认manager。因为覆盖get_query_set() 了,你可能接受到一个无用的返回对像,你必须避免这种情况。

Posted in 未分类

发表评论