经过前面一节的学习,我们基本上已经会使用模型了,本节课开始,我们学习模型的高级应用。
当然,创建新的数据库,并更新之中的数据是必要的,但是,对于 Web 应用程序来说,更多的时候是在检索查询数据库。 我们已经知道如何从一个给定的模型中取出所有记录:
>>> Publisher.objects.all() [<Publisher: Apress>, <Publisher: O'Reilly>]
这相当于这个 SQL 语句:
SELECT id, name, address, city, state_province, country, website FROM books_publisher;
注意
注意到 Django 在选择所有数据时并没有使用
SELECT
,而是显式列出了所有字段。设计的时候就是这样:SELECT
会更慢,而且最重要的是列出所有字段遵循了Python 界的一个信条:明言胜于暗示。
有关Python之禅(戒律):-),在 Python 提示行输入 import this
试试看。
让我们来仔细看看 Publisher.objects.all()
这行的每个部分:
首先,我们有一个已定义的模型Publisher
。没什么好奇怪的:你想要查找数据,你就用模型来获得数据。然后,是objects
属性。它被称为管理器,我们将在第 10 章中详细讨论它。目前,我们只需了解管理器管理着所有针对数据包含、还有最重要的数据查询的表格级操作。所有的模型都自动拥有一个objects
管理器;你可以在想要查找数据时使用它。最后,还有all()
方法。这个方法返回返回数据库中所有的记录。尽管这个对象看起来象一个列表(list),它实际是一个 QuerySet 对象, 这个对象是数据库中一些记录的集合。同学们可以自行搜索关于 QuerySet 的更多知识。现在,我们就先当它是一个仿真列表对象好了。
所有的数据库查找都遵循一个通用模式:
我们很少会一次性从数据库中取出所有的数据;通常都只针对一部分数据进行操作。在
Django API 中,我们可以使用 filter()
方法对数据进行过滤:
>>> Publisher.objects.filter(name='Apress') [<Publisher: Apress>]
filter()
根据关键字参数来转换成 WHERE
SQL
语句。前面这个例子 相当于这样:
SELECT id, name, address, city, state_province, country, website FROM books_publisher WHERE name = 'Apress';
你可以传递多个参数到 filter()
来缩小选取范围:
>>> Publisher.objects.filter(country="U.S.A.", state_province="CA") [<Publisher: Apress>]
多个参数会被转换成 AND
SQL从句,因此上面的代码可以转化成这样:
SELECT id, name, address, city, state_province, country, website FROM books_publisher WHERE country = 'U.S.A.' AND state_province = 'CA';
注意,SQL 缺省的 =
操作符是精确匹配的,其他类型的查找也可以使用:
>>> Publisher.objects.filter(name__contains="press") [<Publisher: Apress>]
在 name 和 contains
之间有双下划线。和 Python 一样,Django
也使用双下划线来表明会进行一些魔术般的操作。这里,contains
部分会被 Django 翻译成 LIKE
语句:
SELECT id, name, address, city, state_province, country, website FROM books_publisher WHERE name LIKE '%press%';
其他的一些查找类型有:icontains
(大小写无关的LIKE
),startswith
和endswith
,
还有range
(SQLBETWEEN
查询)。其它查找类型用到的时候可以自行搜索。
上面的例子中 filter()
函数返回一个记录集,这个记录集是一个列表。相对列表来说,有些时候我们更需要获取单个的对象,get()
方法就是在此时使用的:
>>> Publisher.objects.get(name="Apress") <Publisher: Apress>
这样,就返回了单个对象,而不是列表(更准确的说,QuerySet)。所以,如果结果是多个对象,会导致抛出异常:
>>> Publisher.objects.get(country="U.S.A.") Traceback (most recent call last): ... MultipleObjectsReturned: get() returned more than one Publisher -- it returned 2! Lookup parameters were {'country': 'U.S.A.'}
如果查询没有返回结果也会抛出异常:
>>> Publisher.objects.get(name="Penguin") Traceback (most recent call last): ... DoesNotExist: Publisher matching query does not exist.
这个 DoesNotExist
异常是 Publisher 这个 model 类的一个属性,即
Publisher.DoesNotExist
。在你的应用中,你可以捕获并处理这个异常,像这样:
try: p = Publisher.objects.get(name='Apress') except Publisher.DoesNotExist: print "Apress isn't in the database yet." else: print "Apress is in the database."
在运行前面的例子中,你可能已经注意到返回的结果是无序的。我们还没有告诉数据库怎样对结果进行排序,所以我们返回的结果是无序的。
在你的 Django 应用中,你或许希望根据某字段的值对检索结果排序,比如说,按字母顺序。那么,使用 order_by()
这个方法就可以搞定了。
>>> Publisher.objects.order_by("name") [<Publisher: Apress>, <Publisher: O'Reilly>]
跟以前的 all()
例子差不多,SQL 语句里多了指定排序的部分:
SELECT id, name, address, city, state_province, country, website FROM books_publisher ORDER BY name;
我们可以对任意字段进行排序:
>>> Publisher.objects.order_by("address") [<Publisher: O'Reilly>, <Publisher: Apress>] >>> Publisher.objects.order_by("state_province") [<Publisher: Apress>, <Publisher: O'Reilly>]
如果需要以多个字段为标准进行排序(第二个字段会在第一个字段的值相同的情况下被使用到),使用多个参数就可以了,如下:
>>> Publisher.objects.order_by("state_province", "address") [<Publisher: Apress>, <Publisher: O'Reilly>]
我们还可以指定逆向排序,在前面加一个减号 -
前缀:
>>> Publisher.objects.order_by("-name") [<Publisher: O'Reilly>, <Publisher: Apress>]
尽管很灵活,但是每次都要用 order_by()
显得有点啰嗦。大多数时间你通常只会对某些 字段进行排序。在这种情况下,Django
让你可以指定模型的缺省排序方式:
class Publisher(models.Model): name = models.CharField(max_length=30) address = models.CharField(max_length=50) city = models.CharField(max_length=60) state_province = models.CharField(max_length=30) country = models.CharField(max_length=50) website = models.URLField() def __unicode__(self): return self.name **class Meta:** **ordering = ['name']**
现在,让我们来接触一个新的概念。class Meta
,内嵌于 Publisher
这个类的定义中(如果 class Publisher
是顶格的,那么 class Meta
在它之下要缩进4个空格--按 Python
的传统 )。你可以在任意一个 模型 类中使用 Meta
类,来设置一些与特定模型相关的选项。关于 Meta
中更多可选项的完整参考可以自行搜索,现在,我们关注 ordering
这个选项就够了。
如果你设置了这个选项,那么除非你检索时特意额外地使用了
order_by()
,否则,当你使用 Django 的数据库 API 去检索时,Publisher
对象的相关返回值默认地都会按
name
字段排序。
我们已经知道如何对数据进行过滤和排序。 当然,通常我们需要同时进行过滤和排序查询的操作。 因此,你可以简单地写成这种“链式”的形式:
>>> Publisher.objects.filter(country="U.S.A.").order_by("-name") [<Publisher: O'Reilly>, <Publisher: Apress>]
你应该没猜错,转换成SQL查询就是 WHERE
和 ORDER BY
的组合:
SELECT id, name, address, city, state_province, country, website FROM books_publisher WHERE country = 'U.S.A' ORDER BY name DESC;
另一个常用的需求就是取出固定数目的记录。 想象一下你有成千上万的出版商在你的数据库里, 但是你只想显示第一个。 你可以使用标准的Python列表裁剪语句:
>>> Publisher.objects.order_by('name')[0] <Publisher: Apress>
这相当于:
SELECT id, name, address, city, state_province, country, website FROM books_publisher ORDER BY name LIMIT 1;
类似的,你可以用Python的range-slicing语法来取出数据的特定子集:
>>> Publisher.objects.order_by('name')[0:2]
这个例子返回两个对象,等同于以下的SQL语句:
SELECT id, name, address, city, state_province, country, website FROM books_publisher ORDER BY name OFFSET 0 LIMIT 2;
注意,不支持Python的负索引(negative slicing):
>>> Publisher.objects.order_by('name')[-1] Traceback (most recent call last): ... AssertionError: Negative indexing is not supported.
虽然不支持负索引,但是我们可以使用其他的方法。 比如,稍微修改 order_by() 语句来实现:
>>> Publisher.objects.order_by('-name')[0]
在“插入和更新数据”小节中,我们有提到模型的save()方法,这个方法会更新一行里的所有列。 而某些情况下,我们只需要更新行里的某几列。
例如说我们现在想要将 Apress Publisher 的名称由原来的”Apress”更改为”Apress Publishing”。若使用 save()方法,如:
>>> p = Publisher.objects.get(name='Apress') >>> p.name = 'Apress Publishing' >>> p.save()
这等同于如下 SQL 语句:
SELECT id, name, address, city, state_province, country, website FROM books_publisher WHERE name = 'Apress'; UPDATE books_publisher SET name = 'Apress Publishing', address = '2855 Telegraph Ave.', city = 'Berkeley', state_province = 'CA', country = 'U.S.A.', website = 'http://www.apress.com' WHERE id = 52;
(注意在这里我们假设 Apress 的 ID 为 52)
在这个例子里我们可以看到 Django 的 save() 方法更新了不仅仅是 name 列的值,还有更新了所有的列。若 name 以外的列有可能会被其他的进程所改动的情况下,只更改 name 列显然是更加明智的。更改某一指定的列,我们可以调用结果集(QuerySet)对象的update()方法: 示例如下:
>>> Publisher.objects.filter(id=52).update(name='Apress Publishing')
与之等同的 SQL 语句变得更高效,并且不会引起竞态条件。
UPDATE books_publisher SET name = 'Apress Publishing' WHERE id = 52;
update() 方法对于任何结果集(QuerySet)均有效,这意味着你可以同时更新多条记录。以下示例演示如何将所有Publisher的country字段值由’U.S.A’更改为’USA’:
>>> Publisher.objects.all().update(country='USA') 2
update() 方法会返回一个整型数值,表示受影响的记录条数。在上面的例子中,这个值是2。