跨平台开发 / 系统课时

从 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。

dart
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()));
}

预期输出:

text
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 仍然直接清楚。只要模型开始成批出现,并频繁包含重命名、嵌套对象、列表或可空字段,就应考虑把机械映射交给生成工具,把人工注意力留给字段语义和边界规则。

按自己的节奏,确认真正理解。

目录与阅读设置

记录一个想法

从 Map 手写模型转换

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通