来学习Django 3.0的Field.choices枚举类型

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/ 
译者：桃夭

(完）