跨平台开发 / 系统课时

把 JSON 转成 Dart 对象

把 JSON 转成 Dart 对象

接口返回的数据通常是动态 Map 结构,直接在页面中操作会导致类型不明确、字段散落和维护困难。本篇将学习如何把 JSON 数据转换为 Dart 模型对象,让 Flutter 应用使用更安全、清晰的数据结构。

学习目标

  • 理解 JSON、Map 与 Dart 对象之间的转换关系
  • 掌握使用模型类封装接口数据的方法
  • 能够为网络请求结果设计可维护的数据模型

为什么需要数据模型

Flutter 中通过 HTTP 请求获取的数据通常来自 JSON,例如用户信息接口可能返回如下结构:

json
{
  "id": 1,
  "name": "Alice",
  "email": "alice@example.com"
}

如果页面直接使用 Map<String, dynamic> 读取字段,代码会依赖字符串键名,字段变化时不容易发现问题。使用 Dart 类表示数据,可以获得明确的字段定义和更好的代码提示。

数据转换过程通常包含两个方向:

转换方向 作用
JSON → Dart 对象 接收接口响应,在应用中使用
Dart 对象 → JSON 提交表单或发送请求

使用工厂方法解析 JSON

Dart 模型通常通过 fromJson 方法完成解析。下面定义一个用户模型,并将接口返回的 Map 转换为对象。

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

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

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

void main() {
  final json = <String, dynamic>{
    'id': 1,
    'name': 'Alice',
    'email': 'alice@example.com',
  };

  final user = User.fromJson(json);

  print(user.name);
}

预期输出

text
Alice

factory 构造方法适合处理创建逻辑复杂的对象。这里把字段映射集中在模型内部,页面和业务代码不需要关心 JSON 的具体结构。

处理接口字段变化

真实接口中经常出现可选字段或字段缺失情况。例如昵称可能不存在:

dart
class Profile {
  final String name;
  final String? avatar;

  Profile({
    required this.name,
    this.avatar,
  });

  factory Profile.fromJson(Map<String, dynamic> json) {
    return Profile(
      name: json['name'] as String,
      avatar: json['avatar'] as String?,
    );
  }
}

对于可能为空的数据,应使用可空类型 String?、int? 等表达真实业务状态,而不是假设接口永远返回完整字段。

在网络请求中使用模型

当接口层返回模型对象后,页面代码只需要处理业务数据:

dart
Future<User> fetchUser() async {
  final response = await getUserJson();
  return User.fromJson(response);
}

预期结果

text
fetchUser 返回 User 对象,页面可以直接访问 user.name、user.email 等字段。

模型转换的关键不是减少代码量,而是建立接口数据和业务逻辑之间的边界。当接口结构变化时,只需要调整模型解析部分,页面代码可以保持稳定。

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

目录与阅读设置

阅读设置

17

记录一个想法

把 JSON 转成 Dart 对象

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

登录哪都通