Django F()表达式

Django F()表达式

一个F()对象代表一个模型字段的值或注释列。使用它可以直接引用模型字段的值并执行数据库操作而不用把它们导入到python的内存中。
相反，Django使用F()对象生成一个描述数据库级别所需操作的SQL表达式。
通过一个例子很容易理解。通常，有人会这样做：

reporter = Reporters.objects.get(name='Tintin')
reporter.stories_field += 1
reporter.save()

这里我们从数据库中取出reporter.stories_field的值放入内存中并使用我们熟悉的python运算符操作它，然后把对象保存到数据库中。但是我们还可以这样做：

from django.db.models import F

reporter = Reporters.objects.get(name='Tintin')
reporter.stories_field = F('stories_field') + 1
reporter.save()

虽然reporter.stories_field = F('stories_field') + 1看起来像常规的Python为实例属性赋值，但实际上它是一个描述数据库上操作的SQL结构。
当Django遇到要给F()实例，它会覆盖标准的Python运算符来创建一个封装的SQL表达式；在这个例子中，指示数据库增加由reorter.stories_field表示的数据库字段。
无论repoter.stories_field的值是或曾是什么，Python永远不需要知道--完全由数据库来处理。Python通过Django的F()类做的所有事情仅是参考某个字段创建SQL语法来描述操作。

实例对象必须重新加载后才能获取以这种方式保存的值：

reporter = Reporters.objects.get(pk=reporter.pk)
# 或者，更简洁的操作
reporter.refresh_from_db()

像上面这样在单个实例中使用，F()可以通过updage()方法被用在QuerySets对象实例中。这样可以省略上面用到的两个查询--get()和save()：

reporter = Reporters.objects.filter(name='Tintin')
reporter.update(stories_field=F('stories_field') + 1)

我们也可以使用update()来增加多个对象的字段值，这样比从数据中取出他们，通过循环挨个增加值，然后再保存回数据库中要更加快速：

Reporters.objects.all().update(stories_field=F('stories_field') + 1)

因此，F()可以通过以下方式提供性能优势：

• 直接在数据库中操作而不是python
• 减少一些操作所需的数据库查询次数

使用F()避免竞争关系

使用F()的另一个好处是使用数据库来更新字段而不是用Python，以此避免竞争关系。
如果有两个Python线程执行上面第一个示例，A线程可能在B线程从数据库检索数据后来检索、增加并保存某个字段值。那么B线程的保存将基于他最初检索到的原始值；而A线程的工作将会丢失。
如果有数据库自身负责更新字段，这个过程将会更加健壮：在执行sasve()和update()时基于数据库中当前的字段值，而不是基于被检索出的实例的值。

F()操作在Model.save()后会持续存在

分配给模型字段的F()对象在模型实例保存后依然保持不变，并会应用于之后的每个save()。例如：

reporter = Reporters.objects.get(name='Tintin')
reporter.stories_field = F('stories_field') + 1
reporter.save()  # F()表达式第一次执行

reporter.name = 'Tintin Jr')
reporter.save()  # F()表达式第二次执行

stories_field将会被更新两次！如果初始值为1，那么最终值将会是3

在过滤器(filter)中使用F()

F()在QuerySet过滤器中也非常有用，通过它可以实现基于自身字段值来过滤一组对象，而不是通过Python值。
F()实例充当查询中一个模型字段的引用。这些引用在查询过滤器可以被用来比较同一模型实例的两个不同字段的值。
例如，我们要查找所有Blog记录中comment多于pingback的记录，我们构建一个F()对象来引用pingback的数量：

"""
class Entry(models.Model):
    blog = models.ForeignKey(Blog, on_delete=models.CASCADE)
    headline = models.CharField(max_length=255)
    body_text = models.TextField()
    pub_date = models.DateField()
    mod_date = models.DateField()
    authors = models.ManyToManyField(Author)
    n_comments = models.IntegerField()
    n_pingbacks = models.IntegerField()
    rating = models.IntegerField()

    def __str__(self):
        return self.headline
"""

from django.db.models import F
Entry.objects.filter(n_commnets__gt=F('n_pingbacks'))

Django支持F()对象使用加、减、乘、除、取模和幂运算等算术操作，两个操作数可以是常数或F()对象。要查询blog记录中comment大于两本pingback的记录，修改查询为：

Entry.objects.filter(n_comments__gt=F('n_pingbacks') * 2)

为了查询rating 比pingback 和comment 数目总和要小的记录，我们将这样查询：

Entry.objects.filter(rating__lt=F('n_comments') + F('n_pingbacks'))

你还可以在F() 对象中使用双下划线标记来跨越关联关系。 带有双下划线的F() 对象将引入任何需要的join 操作以访问关联的对象。 例如，如要获取author 的名字与blog 名字相同的Entry，我们可以这样查询:

Entry.objects.filter(authors__name=F('blog__name'))

对于date 和date/time 字段，你可以给它们加上或减去一个timedelta对象。 下面的例子将返回发布超过3天后被修改的所有Entry：

from datetime import timedelta
Entry.objects.filter(mod_date__gt=F('pub_date') + timedelta(days=3))

在annotate中使用F()

F()可以使用算术运算组合不同字段在模型中创建动态字段。

company = Company.objects.annotate(chairs_needed=F('num_employee') - F('num_chairs'))

如果组合的是不同类型的字段，你需要告诉Django返回值是哪种字段类型。由于F()不直接支持output_field，所以需要使用ExpressionWrapper来封装表达式：

from django.db.models import DatetimeField, ExpressionWrapper, F
Ticket.objects.annotate(
	expires=ExpressionWrapper(
	    F('active_at') + F('duration'), output_field=DateTimeField()
	)
)

当引用关联字段(如ForeignKey)时，F()返回的主键值而不是一个模型实例：

>>> car = Company.objects.annotate(built_by=F('manufacturrer'))[0]
>>> car.manufacturer
<Manufacturer: Toyota>
>>> car.built_by
3

使用F()对null值排序

使用F()和传递nulls_first或nulls_last参数给Expression.asc()或desc()来控制字段的null值的排序。默认情况下这个排序取决于你的数据库。
例如，要将未联系过(last_contacted为null)的公司排在已联系过的公司后面：

from django.db.models import F
Company.objects.order_by(F('last_contacted').desc(nulls_last=True))

翻译自Django文档