Dart扩展现有数据模型：Firestore果蔬扫描多类型结果实现问题

问题1 方案选型结论 #

优先选择「苹果、葡萄类继承自统一商品基类」的方案，相比为每种商品单独编写XXXScanData的方案优势明显：

• 代码复用率高：ScanData中的userID、scanName等公共字段无需在各子类重复定义
• 扩展性更强：后续新增品类只需要新增对应的商品子类，无需修改ScanData的核心结构
• 类型安全性更好：替换原来的dynamic类型声明，编译期就能检查类型错误，避免运行时踩坑

问题2 实现示例 #

示例已修正原代码中的两处笔误：1. Firestore字段commmodity多拼写的m统一修正为commodity；2. Grapes.fromMap中错误返回Apple实例的问题也同步修正。

// 首先定义统一的商品抽象基类
abstract class Commodity {
  // 所有商品共有的公共字段可以统一定义在这里
  String? color;
  Commodity({this.color});
  
  // 统一的fromMap工厂方法约定，自动匹配对应商品子类
  factory Commodity.fromMap(String commodityType, Map<String, dynamic> json) {
    switch (commodityType) {
      case 'Apples':
        return Apples.fromMap(json);
      case 'Grapes':
        return Grapes.fromMap(json);
      default:
        throw UnimplementedError('未适配的商品类型：$commodityType');
    }
  }
}

// 苹果子类
class Apples extends Commodity {
  double? size;

  Apples({super.color, this.size});

  factory Apples.fromMap(Map<String, dynamic> json) {
    return Apples(
      color: json['color'],
      size: json['size']?.toDouble(),
    );
  }
}

// 葡萄子类
class Grapes extends Commodity {
  int? number;

  Grapes({super.color, this.number});

  factory Grapes.fromMap(Map<String, dynamic> json) {
    return Grapes(
      color: json['color'],
      number: json['number'] as int?,
    );
  }
}

// 改造后的ScanData类
class ScanData {
  String? userID;
  String? scanName;
  String? commodityType;
  // 不再用dynamic，改为基类类型保证类型安全
  Commodity? result;

  ScanData({this.userID, this.scanName, this.commodityType, this.result});

  factory ScanData.fromMap(Map<String, dynamic> json) {
    final commodityType = json['commodity'] as String;
    return ScanData(
      userID: json['userID'] as String?,
      scanName: json['scanName'] as String?,
      commodityType: commodityType,
      // 自动生成对应商品类实例
      result: Commodity.fromMap(commodityType, json['result'] as Map<String, dynamic>),
    );
  }
}

使用示例 #

// 模拟从Firestore拿到的苹果扫描数据
Map<String, dynamic> appleScanJson = {
  "userID": "Dummy",
  "scanName": "0",
  "commodity": "Apples",
  "result": {"color": "bright red", "size": 8.5}
};
// 解析
final appleScan = ScanData.fromMap(appleScanJson);
// 转型后即可访问对应商品的专属字段
if (appleScan.result is Apples) {
  print((appleScan.result as Apples).size); // 输出8.5
}

// 葡萄扫描数据同理
Map<String, dynamic> grapeScanJson = {
  "userID": "Dummy",
  "scanName": "1",
  "commodity": "Grapes",
  "result": {"color": "black", "number": 40}
};
final grapeScan = ScanData.fromMap(grapeScanJson);
if (grapeScan.result is Grapes) {
  print((grapeScan.result as Grapes).number); // 输出40
}

后续新增商品品类时，只需要新增继承自Commodity的子类，同时在Commodity.fromMap的switch分支中增加对应商品类型的处理逻辑即可，无需改动ScanData的现有代码。

内容的提问来源于stack exchange，提问作者RealRK