基于 Django1.10 文档的深入学习（13）—— Making queries 之 Q objects

Complex lookups with Q objects使用Q对象进行复杂查找

关键字参数查询 - 在filter（）等中与“AND”一起编辑。 如果需要执行更复杂的查询（例如，使用OR语句的查询），则可以使用Q对象。

Q对象（django.db.models.Q）是用于封装关键字参数集合的对象。 这些关键字参数在上面的“字段查找”中指定。

---

例如，这个Q对象封装了一个LIKE查询：

from django.db.models import Q
Q(question__startswith='What')

---

可以使用＆和|组合Q对象运营商。 当在两个Q对象上使用操作符时，它将产生一个新的Q对象。

例如，该语句产生一个单一的Q对象，它表示两个“question__startswith”查询的“OR”：

Q(question__startswith='Who') | Q(question__startswith='What')

这相当于以下SQL WHERE子句：

WHERE question LIKE 'Who%' OR question LIKE 'What%'

---

通过将Q对象与＆和|组合，可以组合任意复杂的语句 运算符和使用括号分组。 此外，可以使用〜运算符来取消Q对象，允许组合查找结合正常查询和否定（NOT）查询：

Q(question__startswith='Who') | ~Q(pub_date__year=2005)

---

使用关键字参数（例如filter（），exclude（），get（））的每个查找函数也可以将一个或多个Q对象作为位置（未命名）参数传递。 如果您向查找函数提供多个Q对象参数，则参数将一起“AND”。 例如：

Poll.objects.get(
    Q(question__startswith='Who'),
    Q(pub_date=date(2005, 5, 2)) | Q(pub_date=date(2005, 5, 6))
)

…大致翻译成SQL：

SELECT * from polls WHERE question LIKE 'Who%'
    AND (pub_date = '2005-05-02' OR pub_date = '2005-05-06')

---

查找功能可以混合使用Q对象和关键字参数。 提供给查找函数的所有参数（无论是关键字参数还是Q对象）都与“AND”一起编辑。 但是，如果提供了一个Q对象，则它必须位于任何关键字参数的定义之前。 例如：

Poll.objects.get(
    Q(pub_date=date(2005, 5, 2)) | Q(pub_date=date(2005, 5, 6)),
    question__startswith='Who',
)

…将是一个有效的查询，相当于前面的例子; 但：

# INVALID QUERY
Poll.objects.get(
    question__startswith='Who',
    Q(pub_date=date(2005, 5, 2)) | Q(pub_date=date(2005, 5, 6))
)

…不会有效。