json_converters_lite 是一个用于在 Flutter 中简化 JSON 数据转换的插件。它可以帮助开发者轻松地将 JSON 数据转换为 Dart 对象，以及将 Dart 对象转换为 JSON 数据。这个插件特别适用于需要处理大量 JSON 数据的应用场景。

安装

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

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

然后运行 flutter pub get 来安装依赖。

基本用法

1. 创建模型类

假设你有一个如下的 JSON 数据：

{
  "id": 1,
  "name": "John Doe",
  "email": "john.doe@example.com"
}

你可以创建一个对应的 Dart 模型类：

import 'package:json_converters_lite/json_converters_lite.dart';

class User {
  int id;
  String name;
  String email;

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

  factory User.fromJson(Map<String, dynamic> json) {
    return User(
      id: json['id'],
      name: json['name'],
      email: json['email'],
    );
  }

  Map<String, dynamic> toJson() {
    return {
      'id': id,
      'name': name,
      'email': email,
    };
  }
}

2. 使用 json_converters_lite 进行转换

你可以使用 json_converters_lite 提供的工具类来简化 JSON 转换过程。

从 JSON 字符串转换为 Dart 对象

import 'package:json_converters_lite/json_converters_lite.dart';

void main() {
  String jsonString = '{"id": 1, "name": "John Doe", "email": "john.doe@example.com"}';
  
  User user = JsonConvertersLite.fromJson<User>(jsonString, User.fromJson);
  
  print(user.name);  // 输出: John Doe
}

从 Dart 对象转换为 JSON 字符串

import 'package:json_converters_lite/json_converters_lite.dart';

void main() {
  User user = User(id: 1, name: "John Doe", email: "john.doe@example.com");
  
  String jsonString = JsonConvertersLite.toJson<User>(user, (user) => user.toJson());
  
  print(jsonString);  // 输出: {"id":1,"name":"John Doe","email":"john.doe@example.com"}
}

高级用法

json_converters_lite 还支持更复杂的 JSON 结构，例如嵌套对象、列表等。

嵌套对象

假设你有一个包含嵌套对象的 JSON 数据：

{
  "id": 1,
  "name": "John Doe",
  "address": {
    "street": "123 Main St",
    "city": "Anytown",
    "zipcode": "12345"
  }
}

你可以创建对应的模型类：

class Address {
  String street;
  String city;
  String zipcode;

  Address({required this.street, required this.city, required this.zipcode});

  factory Address.fromJson(Map<String, dynamic> json) {
    return Address(
      street: json['street'],
      city: json['city'],
      zipcode: json['zipcode'],
    );
  }

  Map<String, dynamic> toJson() {
    return {
      'street': street,
      'city': city,
      'zipcode': zipcode,
    };
  }
}

class User {
  int id;
  String name;
  Address address;

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

  factory User.fromJson(Map<String, dynamic> json) {
    return User(
      id: json['id'],
      name: json['name'],
      address: Address.fromJson(json['address']),
    );
  }

  Map<String, dynamic> toJson() {
    return {
      'id': id,
      'name': name,
      'address': address.toJson(),
    };
  }
}

然后你可以像之前一样进行 JSON 转换。

列表

如果你有一个包含列表的 JSON 数据：

{
  "users": [
    {"id": 1, "name": "John Doe"},
    {"id": 2, "name": "Jane Doe"}
  ]
}

你可以创建对应的模型类：

class UserList {
  List<User> users;

  UserList({required this.users});

  factory UserList.fromJson(Map<String, dynamic> json) {
    var usersJson = json['users'] as List;
    List<User> users = usersJson.map((userJson) => User.fromJson(userJson)).toList();
    
    return UserList(users: users);
  }

  Map<String, dynamic> toJson() {
    return {
      'users': users.map((user) => user.toJson()).toList(),
    };
  }
}

然后进行 JSON 转换：

void main() {
  String jsonString = '{"users": [{"id": 1, "name": "John Doe"}, {"id": 2, "name": "Jane Doe"}]}';
  
  UserList userList = JsonConvertersLite.fromJson<UserList>(jsonString, UserList.fromJson);
  
  print(userList.users[0].name);  // 输出: John Doe
}