跨平台开发 / 系统课时
处理嵌套对象和列表字段
处理嵌套对象和列表字段
当接口返回的数据包含用户详情、订单列表、分页结果等多层 JSON 时,简单的键值读取很快会失控。本篇将学习如何把嵌套对象和列表字段映射为清晰、可维护的 Flutter 数据模型。
学习目标
- 理解嵌套 JSON 与 Dart 模型之间的映射关系
- 掌握对象字段和列表字段的模型拆分方式
- 能够使用模型解析分页等常见接口响应
分析嵌套 JSON 的结构
网络接口通常不会只返回平铺数据,例如用户接口可能同时包含基础信息、地址对象和角色列表:
json
{
"id": 1001,
"name": "Alice",
"profile": {
"age": 20,
"city": "Shanghai"
},
"roles": [
{
"id": 1,
"name": "admin"
},
{
"id": 2,
"name": "editor"
}
]
}解析这类数据时,不建议把所有字段都堆在一个模型中。通常应该根据 JSON 的对象边界拆分模型,让每个类只负责自己的数据。
使用模型表达嵌套对象
Dart 中可以通过多个类组合表达 JSON 层级。对象字段对应另一个模型类型,数组字段对应模型列表。
dart
class User {
final int id;
final String name;
final Profile profile;
final List<Role> roles;
User({
required this.id,
required this.name,
required this.profile,
required this.roles,
});
factory User.fromJson(Map<String, dynamic> json) {
return User(
id: json['id'],
name: json['name'],
profile: Profile.fromJson(json['profile']),
roles: (json['roles'] as List<dynamic>)
.map((item) => Role.fromJson(item))
.toList(),
);
}
}
class Profile {
final int age;
final String city;
Profile({required this.age, required this.city});
factory Profile.fromJson(Map<String, dynamic> json) {
return Profile(
age: json['age'],
city: json['city'],
);
}
}
class Role {
final int id;
final String name;
Role({required this.id, required this.name});
factory Role.fromJson(Map<String, dynamic> json) {
return Role(
id: json['id'],
name: json['name'],
);
}
}预期结果
text
JSON 数据可以被转换为 User 对象,并通过 user.profile 和 user.roles 访问嵌套数据。处理分页列表响应
分页接口通常包含数据列表和分页信息,例如:
json
{
"page": 1,
"total": 50,
"items": [
{
"id": 1,
"title": "Flutter"
}
]
}这种结构适合定义分页模型,把列表元素单独建模:
dart
class PageResult<T> {
final int page;
final int total;
final List<T> items;
PageResult({
required this.page,
required this.total,
required this.items,
});
}实际项目中可以结合代码生成工具自动生成 fromJson,但理解对象拆分原则仍然很重要。模型结构设计错误,会导致后续接口变化时大量修改业务代码。
嵌套模型设计的注意事项
处理复杂 JSON 时,可以遵循以下原则:
- JSON 中稳定存在的对象通常值得独立建模。
- 重复出现的列表元素应该使用独立模型。
- 业务含义明确的结构不要直接使用
Map<String, dynamic>到处传递。 - 接口响应结构变化频繁时,可以在数据模型层隔离变化。
当一个 JSON 同时包含多个层级的数据关系时,模型拆分不是为了增加文件数量,而是为了让数据职责更加清晰。好的模型能够让 UI、状态管理和网络层之间保持低耦合。
按自己的节奏,确认真正理解。