Dart中创建支持JSON序列化的多继承TaxablePerson类的最佳方案

前提说明 #

Dart 本身仅支持单类继承，因此无法直接通过类继承的方式同时复用 Person 和 Taxable 的实现，直接 implements 两个接口需要手动重写所有字段和方法的方案冗余度极高，不推荐使用。

首先先修正你提供的 Taxable 类的笔误：原代码中 Taxable 的构造函数名错误写成了 Person，修正后代码如下：

@JsonSerializable()
class Taxable {
  final String taxNumber;
  // 修正构造函数名笔误
  Taxable({required this.taxNumber});
  factory Taxable.fromJson(Map<String, dynamic> json) => _$TaxableFromJson(json);
  Map<String, dynamic> toJson() => _$TaxableToJson(this);
}

方案一：组合模式（侵入性最低，优先推荐） #

不需要修改原有 Person、Taxable 的任何代码，兼容所有已有依赖这两个类的业务逻辑，仅需要在新类中转发接口要求的属性即可：

@JsonSerializable()
class TaxablePerson implements Person, Taxable {
  /// 持有两个原有类的实例
  final Person person;
  final Taxable taxable;

  /// 转发接口要求的属性，无需重新声明存储字段
  @override
  String get name => person.name;
  @override
  String get taxNumber => taxable.taxNumber;

  TaxablePerson({required this.person, required this.taxable});

  /// 复用原有类的反序列化逻辑
  factory TaxablePerson.fromJson(Map<String, dynamic> json) => TaxablePerson(
    person: Person.fromJson(json),
    taxable: Taxable.fromJson(json),
  );

  /// 合并两个类的序列化结果，输出平展的JSON结构
  @override
  Map<String, dynamic> toJson() => {
    ...person.toJson(),
    ...taxable.toJson(),
  };
}

方案优势 #

• 完全复用原有类的所有逻辑，不需要重复实现字段校验、业务方法等
• 兼容所有要求传入 Person 或 Taxable 类型的方法，符合里氏替换原则
• 序列化/反序列化逻辑无需手动绑定字段，避免出现映射错误

方案二：Mixin改造（适合可调整原有类结构的场景） #

如果你的项目还在开发初期，Person 和 Taxable 没有大量外部依赖，可以将两个类改造为mixin，实现更简洁的多继承效果：

// 改造Person为mixin
mixin Person {
  String get name;

  Map<String, dynamic> personToJson() => {'name': name};
  static Person fromJson(Map<String, dynamic> json) => _PersonImpl.fromJson(json);
}

@JsonSerializable()
class _PersonImpl with Person {
  @override
  final String name;
  _PersonImpl({required this.name});
  factory _PersonImpl.fromJson(Map<String, dynamic> json) => _$_PersonImplFromJson(json);
}

// 改造Taxable为mixin
mixin Taxable {
  String get taxNumber;

  Map<String, dynamic> taxableToJson() => {'taxNumber': taxNumber};
  static Taxable fromJson(Map<String, dynamic> json) => _TaxableImpl.fromJson(json);
}

@JsonSerializable()
class _TaxableImpl with Taxable {
  @override
  final String taxNumber;
  _TaxableImpl({required this.taxNumber});
  factory _TaxableImpl.fromJson(Map<String, dynamic> json) => _$_TaxableImplFromJson(json);
}

// 新类实现
@JsonSerializable()
class TaxablePerson with Person, Taxable {
  @override
  final String name;
  @override
  final String taxNumber;

  TaxablePerson({required this.name, required this.taxNumber});

  factory TaxablePerson.fromJson(Map<String, dynamic> json) => _$TaxablePersonFromJson(json);
  Map<String, dynamic> toJson() => _$TaxablePersonToJson(this);
}

方案优势 #

• 新类的代码冗余度最低，没有额外的嵌套实例
• 后续扩展新方法更方便，直接在mixin中新增即可同步到所有实现类

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