dynamo_json 是一个用于在 Flutter 中简化 JSON 序列化和反序列化的插件。它可以帮助开发者更轻松地将 Dart 对象转换为 JSON 字符串，以及将 JSON 字符串转换为 Dart 对象。以下是使用 dynamo_json 的基本步骤和示例。

1. 添加依赖

首先，你需要在 pubspec.yaml 文件中添加 dynamo_json 的依赖：

dependencies:
  flutter:
    sdk: flutter
  dynamo_json: ^1.0.0  # 请使用最新版本

然后运行 flutter pub get 来获取依赖。

2. 创建模型类

接下来，你需要创建一个 Dart 类来表示你的数据模型，并使用 dynamo_json 的注解来标记需要序列化和反序列化的字段。

import 'package:dynamo_json/dynamo_json.dart';

part 'user_model.g.dart';  // 自动生成的代码文件

[@DynamoJson](/user/DynamoJson)()
class User {
  [@DynamoField](/user/DynamoField)(name: 'id')
  final int id;

  [@DynamoField](/user/DynamoField)(name: 'name')
  final String name;

  [@DynamoField](/user/DynamoField)(name: 'email')
  final String email;

  User({required this.id, required this.name, required this.email});

  factory User.fromJson(Map<String, dynamic> json) => _$UserFromJson(json);

  Map<String, dynamic> toJson() => _$UserToJson(this);
}

3. 生成代码

使用 dynamo_json 提供的命令行工具来生成序列化和反序列化的代码。

在项目根目录下运行以下命令：

flutter pub run dynamo_json:generate

这将会在 user_model.g.dart 文件中生成 _$UserFromJson 和 _$UserToJson 方法。

4. 使用模型类

现在，你可以使用生成的 fromJson 和 toJson 方法来处理 JSON 数据。

import 'user_model.dart';

void main() {
  // JSON 字符串
  String jsonString = '{"id": 1, "name": "John Doe", "email": "john@example.com"}';

  // 将 JSON 字符串转换为 Dart 对象
  Map<String, dynamic> jsonMap = jsonDecode(jsonString);
  User user = User.fromJson(jsonMap);

  print('User ID: ${user.id}');
  print('User Name: ${user.name}');
  print('User Email: ${user.email}');

  // 将 Dart 对象转换回 JSON 字符串
  Map<String, dynamic> userJson = user.toJson();
  String jsonOutput = jsonEncode(userJson);
  print('JSON Output: $jsonOutput');
}

5. 处理复杂结构

如果 JSON 数据结构较为复杂，比如包含嵌套对象或列表，dynamo_json 也能很好地处理。

例如，假设有一个包含 User 对象列表的 JSON：

[@DynamoJson](/user/DynamoJson)()
class UserList {
  [@DynamoField](/user/DynamoField)(name: 'users')
  final List<User> users;

  UserList({required this.users});

  factory UserList.fromJson(Map<String, dynamic> json) => _$UserListFromJson(json);

  Map<String, dynamic> toJson() => _$UserListToJson(this);
}

然后你可以像之前一样生成代码并处理 JSON 数据。

6. 自定义序列化

如果你需要对某些字段进行自定义序列化或反序列化，可以在 DynamoField 注解中指定 converter 参数。

[@DynamoJson](/user/DynamoJson)()
class CustomUser {
  [@DynamoField](/user/DynamoField)(name: 'id', converter: CustomConverter())
  final int id;

  CustomUser({required this.id});

  factory CustomUser.fromJson(Map<String, dynamic> json) => _$CustomUserFromJson(json);

  Map<String, dynamic> toJson() => _$CustomUserToJson(this);
}

class CustomConverter implements DynamoConverter<int, String> {
  [@override](/user/override)
  int fromDynamo(String value) => int.parse(value);

  [@override](/user/override)
  String toDynamo(int value) => value.toString();
}