在Drift中使用抽象类作为行映射的技术探讨

背景介绍

在数据库应用开发中，我们经常会遇到需要处理继承结构的实体类映射到数据库表的情况。Drift作为一个强大的Dart数据库框架，提供了@UseRowClass注解来简化这种映射关系。然而，当我们需要将抽象基类映射到数据库表时，会遇到一些特殊的挑战。

问题场景

假设我们正在开发一个问卷系统，其中有一个基础的问题抽象类AbstractQuestion，以及多个具体的问题子类（如单选题、多选题等）。我们希望：

1. 将所有问题存储在单一的数据库表中
2. 表中包含所有问题共有的字段（如id、title）
3. 同时包含各子类特有的可空字段

技术挑战

直接使用@UseRowClass(AbstractQuestion)会遇到以下问题：

1. 查询时无法自动加载特定子类所需的字段
2. 类型安全性难以保证
3. 插入操作时无法验证特定子类所需的字段是否完整

解决方案一：JSON序列化方案

Drift的维护者推荐的首选方案是将子类特有的数据序列化为JSON存储：

typedef Question<T extends QuestionDetails> = ({int id, String title, T details});

sealed class QuestionDetails {
  static QuestionDetails fromJson(Map<String, Object?> json) {
    // 实现各子类的JSON反序列化
  }
}

@UseRowClass(Question)
class Questions extends Table {
  IntColumn get id => integer().autoIncrement()();
  TextColumn get title => text()();
  BlobColumn get details => blob().map(TypeConverter.jsonb(fromJson: QuestionDetails.fromJson))();
}

优点：

• 表结构清晰简单
• 易于实现分页查询
• 类型安全有保障

缺点：

• 需要实现JSON序列化逻辑
• 查询特定字段时可能需要额外处理

解决方案二：工厂构造函数方案

如果坚持使用单表多列的方式，可以通过工厂构造函数实现：

sealed class AbstractQuestion {
  final int id;
  final String title;

  AbstractQuestion(this.id, this.title);

  factory AbstractQuestion.fromDb(int id, String title, String? onlyForTypeA, String? onlyForTypeB) {
    if (onlyForTypeA != null) {
      return QuestionSubtypeA(id, title, onlyForTypeA);
    }
    // 其他子类的处理逻辑
  }
}

@UseRowClass(AbstractQuestion, constructor: 'fromDb')
class Questions extends Table {
  IntColumn get id => integer().autoIncrement()();
  TextColumn get title => text()();
  TextColumn get onlyForTypeA => text().nullable()();
  TextColumn get onlyForTypeB => text().nullable()();
}

优点：

• 所有字段都直接存储在表中
• 查询性能可能更好

缺点：

• 表结构会随着子类增加而膨胀
• 类型安全性较差
• 维护成本较高

方案选择建议

对于大多数应用场景，推荐使用JSON序列化方案，因为：

1. 更符合现代数据库设计理念
2. 扩展性更好，新增子类时不需要修改表结构
3. 虽然查询特定字段需要额外处理，但现代数据库对JSON操作的支持已经相当完善

只有在以下情况下才考虑使用多列方案：

• 需要频繁查询或索引特定子类的字段
• 系统对查询性能有极高要求
• 子类数量非常有限且稳定

总结