Django 3.0的主要新功能之一是它为模型中的字段属性choice提供了一个新的枚举类型。这个功能是定义和约束Field.choices模型的更好方法。
以前,Django建议在模型的类里定义一些“常量”,并将它们放入choices里。您可以将它们设置为单独的类变量,然后将它们与字符串配对,组合成列表:
然后你就能使用这些常量了,例如:
如果你想在多个模型中使用相同的值,那么需要将这些变量移动到模块级别上:
这样留下了一堆常量,这些常量只与它们在类或模块中的位置有关。这有点违反“Python之禅”的内容:
这也使我们丢失了一些有用的功能。例如,没有简单的方法可以将值转换为它的标签。
更新(2020年1月28日)
正如Airith on REDIT指出的那样,模型实例都提供get_FOO_display()方法用来将值转换为标签。像django-choices和django-enumfields之类的包可以解决这些问题。我还在其他项目中看过几个类似功能的自定义实现。
Django 3.0现在提供了一个有两个子类(IntegerChoices和TextChoices)的Choices类。它们扩展了Python的枚举类型,还有额外的约束条件和功能,使得它们适用于Field.choices。
为了转换我们的示例,我们要继承子类TextChoices,因为这些值是存储在CharField中的字符串。然后,我们定义名称到值的映射,并将标签展示为类属性:
如果没有检测到migration的改变,那么我们就完成了正确的转换:
如果我们添加,删除或重新排序了任何部分,这些都会被检测为字段中的更改。这是因为迁移框架只能检测由Status.choices生成的choices列表,而检测不到枚举类。
QuerySet筛选器更新后就能使用Choices类了:
我们就可以轻松地将值转换为标签:
更简洁了!
结语
我希望这可以帮助您享用Django 3.0的新功能。该枚举类型文献涵盖了一些细节,值得一读。
感谢Shai Berger,Nick Pope,Marius Felisiak,Carlton Gibson,以及所有其他负责添加这项功能的人。
——Adam
英文原文:https://adamj.eu/tech/2020/01/27/moving-to-django-3-field-choices-enumeration-types/
译者:桃夭