跨平台开发 / 系统课时
从 Map 手写模型转换
从 Map 手写模型转换
接口返回 JSON 后,Dart 通常先把它解码成 Map<String, dynamic>。这一节用一个用户响应手写模型转换,完整走过字段读取、运行时校验、类型转换、对象重建与反向序列化,找出最适合交给代码生成器的重复劳动。
学习目标
- 能把
Map<String, dynamic>安全转换为类型明确的 Dart 对象 - 理解
fromJson与toJson分别承担的边界职责 - 识别手写序列化中最容易重复和出错的代码
Map 只是接口数据的中间形态
接口返回的是 JSON 文本,jsonDecode 会先把对象结构解码成 Map。此时键通常是字符串,但值的静态类型仍是 dynamic。如果业务代码一直直接读取 map['created_at'],拼写错误、类型变化和格式问题都会拖到运行时才暴露。
模型层的目标不是把 Map 换一种写法保存,而是把“不可信的外部数据”转换成“内部可依赖的类型”。因此 fromJson 应在边界处完成字段读取、必要校验和格式转换,后续业务代码只操作 User。
手写完整转换链路
下面的程序从一段接口 JSON 文本开始,经过 jsonDecode、User.fromJson、对象访问、toJson 和 jsonEncode,可以直接作为 Dart 控制台程序运行。created_at 在接口中是字符串,进入模型时转换为 DateTime。
import 'dart:convert';
class User {
final int id;
final String name;
final bool active;
final DateTime createdAt;
const User({
required this.id,
required this.name,
required this.active,
required this.createdAt,
});
factory User.fromJson(Map<String, dynamic> json) {
final id = json['id'];
final name = json['name'];
final active = json['active'];
final createdAt = json['created_at'];
// 在接口边界集中校验,避免错误数据进入业务对象。
if (id is! int ||
name is! String ||
active is! bool ||
createdAt is! String) {
throw FormatException('invalid user payload');
}
return User(
id: id,
name: name,
active: active,
createdAt: DateTime.parse(createdAt),
);
}
Map<String, dynamic> toJson() {
// DateTime 先转回字符串,才能安全交给 jsonEncode。
return <String, dynamic>{
'id': id,
'name': name,
'active': active,
'created_at': createdAt.toUtc().toIso8601String(),
};
}
}
void main() {
const rawResponse =
'{"id":42,"name":"Ada","active":true,'
'"created_at":"2026-09-18T03:30:00.000Z"}';
final response = jsonDecode(rawResponse) as Map<String, dynamic>;
final user = User.fromJson(response);
print('${user.id} | ${user.name} | ${user.active}');
print(user.createdAt.toUtc().toIso8601String());
print(jsonEncode(user.toJson()));
}预期输出:
42 | Ada | true
2026-09-18T03:30:00.000Z
{"id":42,"name":"Ada","active":true,"created_at":"2026-09-18T03:30:00.000Z"}这里有两个方向:fromJson 把接口字段名和 JSON 类型收敛成 Dart 类型,toJson 则把对象重新转换为 jsonEncode 能处理的数据。字段命名差异也集中在这两个方法中,业务代码不需要知道 created_at 这种接口命名。
手写代码为什么很快变重
一个四字段模型已经需要声明字段、构造函数、读取键、校验类型、处理特殊格式,再写一遍反向映射。模型一多,重复劳动会沿着三类变化放大:接口新增字段时要同步修改多个位置,字段改名时容易漏改,嵌套对象和列表还会继续增加转换代码。
这正是后续序列化代码生成要替代的部分:重复、机械、规则明确的映射代码。但生成器不会替你决定业务语义,例如字段是否允许为空、字符串日期如何解析、异常数据是拒绝还是兜底。这些约束仍应由模型设计明确表达。
什么时候仍值得手写
模型只有一两个字段、生命周期很短,或者接口需要高度定制的解析规则时,手写 fromJson 仍然直接清楚。只要模型开始成批出现,并频繁包含重命名、嵌套对象、列表或可空字段,就应考虑把机械映射交给生成工具,把人工注意力留给字段语义和边界规则。