BeanieODM中继承模型与集合名称设置的注意事项

在使用BeanieODM进行MongoDB文档建模时，继承是一个非常有用的特性，它允许我们创建具有共同属性的基础模型，并通过继承来扩展这些模型。然而，在使用继承时，集合名称的设置需要特别注意，否则可能会导致文档被意外存储到错误的集合中。

继承模型的基本用法

BeanieODM支持Python风格的类继承，我们可以创建一个基础模型类，然后让其他模型类继承它。例如：

class Vehicle(Document):
    color: str

class Bicycle(Vehicle):
    frame: int
    wheels: int

在这个例子中，Bicycle继承了Vehicle的所有字段，并添加了自己的特定字段。

集合名称的设置问题

默认情况下，Beanie会根据模型类名自动确定集合名称（将类名转换为小写复数形式）。但在继承场景下，如果不正确配置，所有继承类的文档都会被存储到基类的集合中。

正确的配置方法

要使继承类使用自己的集合名称，需要在继承类中定义Settings类并指定name属性，同时不能在基类中设置is_root = True：

class Vehicle(Document):
    color: str

    class Settings:
        pass  # 注意这里不设置is_root=True

class Bicycle(Vehicle):
    frame: int
    wheels: int

    class Settings:
        name = 'bicycles'  # 明确指定集合名称

为什么不能使用is_root=True

is_root=True会告诉Beanie将所有继承类的文档都存储到基类的集合中。这在某些场景下可能是有用的（比如多态查询），但如果希望每个子类有自己的集合，就必须避免在基类中使用这个设置。

实际应用建议

1. 如果希望每个模型类都有自己的集合，不要在基类中设置is_root=True
2. 在子类中明确指定name属性来定义集合名称
3. 考虑在基类中使用抽象基类模式（ABC）来防止直接实例化基类
4. 对于复杂的继承层次，仔细规划集合命名策略以保持一致性

通过正确配置集合名称，我们可以充分利用Beanie的继承特性，同时保持数据在MongoDB中的良好组织。