跨平台开发 / 系统课时
看懂 JSON 对象和数组结构
看懂 JSON 对象和数组结构
本篇解决 Flutter 开发中读取接口数据时无法判断 JSON 结构的问题。通过理解对象、数组、基础值与 null 的对应关系,可以准确设计 Dart 数据类型,为后续模型转换做好准备。
学习目标
- 理解 JSON 常见数据结构及其层级关系。
- 掌握 JSON 类型与 Dart 类型之间的映射规则。
- 能根据接口返回内容判断模型字段设计方式。
JSON 数据的基本组成
JSON 是接口传输数据时常用的格式,它由对象、数组和基础值组成。Flutter 使用 Dart 处理 JSON 时,通常会先将 JSON 解析为 Map<String, dynamic> 或 List<dynamic>,再转换为业务模型。
一个 JSON 对象使用大括号表示,内部由键值对组成。键通常是字符串,值可以继续是对象、数组或基础类型。
json
{
"id": 1001,
"name": "Flutter",
"enabled": true
}这个对象在 Dart 中通常对应:
dart
final Map<String, dynamic> data = {
'id': 1001,
'name': 'Flutter',
'enabled': true,
};对象、数组和基础值映射
接口返回的数据结构决定了 Dart 中接收数据的类型。常见映射关系如下:
| JSON 类型 | 示例 | Dart 类型 |
|---|---|---|
| 对象 | { "name": "Tom" } |
Map<String, dynamic> |
| 数组 | [1, 2, 3] |
List<dynamic> |
| 字符串 | "hello" |
String |
| 数字 | 100 |
int 或 double |
| 布尔值 | true |
bool |
| 空值 | null |
null 或可空类型 |
实际项目中不会长期直接操作这些动态类型,而是会继续转换为强类型模型。例如用户接口可能返回:
json
{
"id": 1,
"username": "alice",
"tags": ["flutter", "dart"]
}对应的数据结构可以理解为:
dart
class User {
final int id;
final String username;
final List<String> tags;
User({
required this.id,
required this.username,
required this.tags,
});
}嵌套结构如何判断
真实接口通常包含多层嵌套,需要先观察层级关系,再决定模型拆分方式。
例如订单接口:
json
{
"orderId": "A001",
"user": {
"id": 10,
"name": "Alice"
},
"items": [
{
"name": "Keyboard",
"price": 99.9
}
]
}其中:
user是对象,适合拆分成独立模型。items是数组,每个元素又是对象,需要设计列表模型。price是小数,应映射为double。
遇到复杂 JSON 时,不要直接根据字段名称猜类型,而应该观察接口实际返回的数据结构。字段是否允许缺失、是否可能为 null,也会影响最终 Dart 类型设计。
null 和可空类型
JSON 中的 null 表示没有值。Dart 空安全模式下,需要使用 ? 表示字段可能为空。
例如接口可能没有返回头像:
dart
class User {
final String name;
final String? avatar;
User({
required this.name,
this.avatar,
});
}如果错误地把可能为空的字段定义成非空类型,在解析阶段可能出现运行异常。
理解 JSON 结构的关键不是记忆类型转换,而是建立从接口数据到 Dart 模型的映射思维:先识别层级,再判断字段类型,最后决定模型结构。
按自己的节奏,确认真正理解。