django-reverse-unique-charettes 1.0

示例

看到实际的用例总是很好的。我们将用时间来塑造员工 本例中的从属工资。这个用例可以建模为：

class Employee(models.Model):
    name = models.TextField()

class EmployeeSalary(models.Model):
    employee = models.ForeignKey(Employee, related_name='employee_salaries')
    salary = models.IntegerField()
    valid_from = models.DateField()
    valid_until = models.DateField(null=True)

可以保存这样的数据：“Anssi从2000年1月1日到2009年12月31日的工资为10欧元， 从2010年1月1日到无限期，工资为11欧元（模型中没有）。

不幸的是，当使用这些模型时，获取 显示给用户的员工及其工资。这样做是有可能的 循环查看雇员的所有工资，并检查哪个雇员的工资 目前有效。但是，这种方法有两个缺点：

• It doesn’t perform well in list views
• Most of all It is impossible to execute queries that refer the employee’s current salary. For example, getting the top 10 best paid employees or the average salary of employees is impossible to achieve in single query.

Django倒车救援独一无二！让我们将员工模型更改为：

from datetime import datetime
class Employee(models.Model):
    name = models.TextField()
    current_salary = models.ReverseUnique(
        "EmployeeSalary",
        filter=Q(valid_from__gte=datetime.now) &
               (Q(valid_until__isnull=True) | Q(valid_until__lte=datetime.now))
    )

现在我们只需发出如下查询：

Employee.objects.order_by('current_salary__salary')[0:10]

或：

Employee.objects.aggregate(avg_salary=Avg('current_salary__salary'))

那里发生了什么事？我们添加了一个reverseunique字段。这个字段是相反的 具有附加限制的employeesalary.employee外键的 关系在执行查询时必须有效。第一次 “employeesalary”参数是指employeesalary模型（我们必须使用 字符串作为employeesalary模型在employee模型之后定义）。这个 filter参数是一个q对象，它可以引用远程模型的字段。

django应用程序的另一个常见问题是如何存储模型转换。 利用django逆唯一性可以解决存储问题。这里是一个完整的 该用例的示例：

from django.db import models
from reverse_unique import ReverseUnique
from django.utils.translation import get_language, activate

class Article(models.Model):
    active_translation = ReverseUnique("ArticleTranslation",
                                       filters=Q(lang=get_language))

class ArticleTranslation(models.Model):
    article = models.ForeignKey(Article)
    lang = models.CharField(max_length=2)
    title = models.CharField(max_length=100)
    body = models.TextField()

    class Meta:
        unique_together = ('article', 'lang')

activate("fi")
objs = Article.objects.filter(
    active_translation__title__icontains="foo"
).select_related('active_translation')
# Generated query is
#    select article.*, article_translation.*
#      from article
#      join article_translation on article_translation.article_id = article.id
#                               and article_translation.lang = 'fi'
# If you activate "en" instead, the lang is changed.
# Now you can access objs[0].active_translation without generating more
# queries.

同样，您可以获取酒店房间等的当前有效预订。

安装

Reverseunique的要求是django 1.6+。你需要把 反转python路径中的唯一目录，然后像上面那样使用它 例子。测试（reverse_unique/tests.py）包含了更多的例子。 最简单的安装方法是：

pip install -e git://github.com/akaariai/django-reverse-unique.git#egg=reverse_unique

测试

您需要安装支持的django版本。去 测试项目目录并运行：

python manage.py test reverse_unique