django-typed-models：模型的类型继承新选择

django-typed-models：模型的类型继承新选择

django-typed-models polymorphic django models using automatic type-field downcasting 项目地址: https://gitcode.com/gh_mirrors/dj/django-typed-models

项目介绍

django-typed-models 为 Django 提供了一种新的模型继承方式。这种方式类似于 Ruby on Rails 中的单表继承（single-table inheritance）。在 django-typed-models 中，每个对象的实际类型会被存储在数据库中，当检索对象时，它会自动转换回正确的模型类。这种设计使得模型之间的关系更加灵活，同时也简化了数据库的结构。

项目技术分析

技术架构

django-typed-models 的核心在于对 Django 模型系统进行扩展，使得模型可以存储额外的类型信息。在技术实现上，它利用了以下几个关键特性：

• 类型字段：在数据库中为每个对象添加一个类型字段（通常为 type），用来记录对象的实际类型。
• 单表继承：所有的子模型都在同一个表中存储，而不是每个子模型一个表，这减少了数据库的复杂度。
• 自动类型转换：在对象检索时，框架会根据类型字段自动将对象实例化为正确的子模型类。

依赖要求

• Django 版本：django-typed-models 需要 Django 4.2 或更高版本。
• Python 版本：支持的 Python 版本为 3.9 或更高。

项目及技术应用场景

应用场景

django-typed-models 的设计特别适用于以下几种场景：

• 多态行为：当你的模型需要表现出多种不同的行为时，如动物模型中，不同的动物有不同的叫声。
• 灵活的数据结构：当你的数据结构可能发生变化，或者你需要能够动态添加新的子类时。
• 单表存储：当你希望所有相关的数据都存储在同一个表中，而不是分散在多个表中时。

示例应用

以下是一个简单的使用示例：

# 定义基类和子类
class Animal(TypedModel):
    name = models.CharField(max_length=255)

    def say_something(self):
        raise NotImplemented

class Canine(Animal):
    def say_something(self):
        return "woof"

class Feline(Animal):
    mice_eaten = models.IntegerField(default=0)

    def say_something(self):
        return "meoww"

# 使用模型
Feline.objects.create(name="kitteh")
Canine.objects.create(name="fido")
print(Animal.objects.all())

在这个例子中，Animal 是一个抽象基类，而 Canine 和 Feline 是具体的子类。创建对象时，它们的类型会被存储在数据库中，并且可以通过基类查询到所有子类的实例。

项目特点

自动类型转换

在查询集（querysets）中的模型将自动具有正确的类，无需额外的类型检查或转换。

单表存储

所有继承自共同基类的模型都在同一个表中存储，减少了数据库的表数量，简化了数据结构。

类型存储

对象类型存储在数据库中的 type 字段，确保了类型的持久性。

无额外查询

检索多个类型时无需额外的查询或连接操作，提高了查询效率。

类型修改

可以轻松地通过更新查询来修改对象的类型，或者使用 recast 方法在不刷新数据库的情况下修改类型。

Django admin 集成

django-typed-models 还提供了对 Django admin 的支持，允许你通过基类 admin 创建新的子类实例，并隐藏类型字段。

限制

尽管 django-typed-models 功能强大，但它也有一些限制：

• 所有字段在子类中都是可选的（nullable）。
• 子类中定义的字段只能在一个子类中使用，除非这些字段完全相同。

通过上述分析，django-typed-models 显然是一个值得关注的 Django 扩展项目，它为 Django 开发者提供了一个更加灵活和强大的模型继承方案。无论你是需要实现多态行为，还是希望简化数据库结构，django-typed-models 都可能成为你的首选工具。

django-typed-models polymorphic django models using automatic type-field downcasting 项目地址: https://gitcode.com/gh_mirrors/dj/django-typed-models