跨平台开发 / 系统课时

处理嵌套对象和列表字段

处理嵌套对象和列表字段

当接口返回的数据包含用户详情、订单列表、分页结果等多层 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、状态管理和网络层之间保持低耦合。

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

目录与阅读设置

阅读设置

17

记录一个想法

处理嵌套对象和列表字段

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

登录哪都通