如何在Dart/Flutter中实现JsonConverter？报错“仅能扩展类”

核心问题分析 #

报错和依赖导入无关（只要已在pubspec.yaml中正确添加依赖），问题出在代码不符合json_annotation包的规范，具体如下：

• 使用了无效的JSON类型：Dart中没有内置JSON类型，需替换为具体的JSON表示类型，比如Map<String, dynamic>（最常用）或String。
• 未实现抽象类的必要方法：JsonConverter是抽象类，必须重写fromJson和toJson方法。
• 缺少const构造函数：自定义转换器作为注解使用时，必须提供const构造函数。

修正后的代码示例 #

import 'package:json_annotation/json_annotation.dart';

// 假设这是你自定义的Value类型
class Value {
  final String content;
  Value(this.content);
}

class MyJsonConverter extends JsonConverter<Value, Map<String, dynamic>> {
  // 必须添加const构造函数，用于注解
  const MyJsonConverter();

  @override
  Value fromJson(Map<String, dynamic> json) {
    // 实现从JSON到Value的转换逻辑
    return Value(json['content'] as String);
  }

  @override
  Map<String, dynamic> toJson(Value object) {
    // 实现从Value到JSON的转换逻辑
    return {'content': object.content};
  }
}

@JsonSerializable()
@MyJsonConverter()
class Example {
  final Value property;

  Example(this.property);

  // 必须生成序列化/反序列化方法（需配合build_runner运行生成）
  factory Example.fromJson(Map<String, dynamic> json) => _$ExampleFromJson(json);
  Map<String, dynamic> toJson() => _$ExampleToJson(this);
}

必要的依赖配置 #

确保pubspec.yaml中已添加以下依赖：

dependencies:
  json_annotation: ^4.8.1 # 使用最新版本

dev_dependencies:
  build_runner: ^2.4.4
  json_serializable: ^6.7.0

配置完成后，运行以下命令生成序列化代码：

dart pub run build_runner build

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