跨平台开发 / 系统课时
把 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
Alicefactory 构造方法适合处理创建逻辑复杂的对象。这里把字段映射集中在模型内部,页面和业务代码不需要关心 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 等字段。模型转换的关键不是减少代码量,而是建立接口数据和业务逻辑之间的边界。当接口结构变化时,只需要调整模型解析部分,页面代码可以保持稳定。
按自己的节奏,确认真正理解。