跨平台开发 / 系统课时
区分缺失值与 null
区分缺失值与 null
接口字段缺失、值为 null、值为空字符串是三种不同输入,但直接读取 map['key'] 时前两者都会得到 null。本节用 containsKey 拆开三种状态,并据此决定字段应必填、可空、给默认值,还是保留额外状态。
学习目标
- 区分字段缺失、值为
null与空字符串三种输入 - 根据接口语义选择必填、可空或默认值字段
- 知道什么时候必须用
containsKey保留“是否出现”这一层信息
直接取值会丢掉一层信息
Dart 的 Map 在键不存在时返回 null,键存在且值本身为 null 时也返回 null。因此只看 json['nickname'] 无法判断接口究竟省略了字段,还是明确发送了空值。
下面的程序把三种情况放在一起比较:
String showValue(Object? value) {
if (value == null) return 'null';
if (value == '') return '<empty>';
return value.toString();
}
void inspect(String label, Map<String, dynamic> json) {
// containsKey 保留“字段有没有出现”这层信息。
final exists = json.containsKey('nickname');
final value = json['nickname'];
print(
'$label -> containsKey=$exists, value=${showValue(value)}',
);
}
void main() {
// 三个 Map 只改变 nickname 的存在方式,便于直接比较。
inspect('missing', <String, dynamic>{'name': 'Ada'});
inspect('null', <String, dynamic>{
'name': 'Ada',
'nickname': null,
});
inspect('empty', <String, dynamic>{
'name': 'Ada',
'nickname': '',
});
}预期输出:
missing -> containsKey=false, value=null
null -> containsKey=true, value=null
empty -> containsKey=true, value=<empty>containsKey 判断“字段是否出现”,索引读取判断“字段值是什么”。空字符串则是一个真实的 String 值,不会被 Dart 空安全自动当成 null。
用接口语义决定字段类型
字段类型应表达接口契约,而不是为了避免报错一律写成可空。
| 接口语义 | 模型设计 | 典型处理 |
|---|---|---|
必须出现且不能为 null |
String、int 等非空类型 |
缺失或 null 时拒绝解析 |
可以明确返回 null |
String? 等可空类型 |
保留 null 给业务层判断 |
缺失或 null 都等价于默认值 |
非空类型加默认值 | 使用 ?? 合并两种情况 |
缺失与 null 含义不同 |
额外保存“是否出现”状态 | 先用 containsKey,再读取值 |
例如语言字段约定“缺失或 null 都使用 zh-CN”,可以写成 json['locale'] as String? ?? 'zh-CN'。但这不会把空字符串替换掉,因为 '' 不是 null。如果空字符串也非法,应单独做业务校验,而不是依赖空安全。
必填字段要在边界失败
片段示例:下面的方法假设已有包含 name、nickname、locale 字段和对应构造函数的 Profile 类,用来展示解析策略,不能独立运行。
factory Profile.fromJson(Map<String, dynamic> json) {
final name = json['name'];
if (name is! String || name.isEmpty) {
throw FormatException('name must be a non-empty string');
}
return Profile(
name: name,
nickname: json['nickname'] as String?,
locale: json['locale'] as String? ?? 'zh-CN',
);
}这里的 name 是必填非空字段,所以缺失、null 或空字符串都会在模型边界失败;nickname 允许 null;locale 把缺失和 null 合并成默认值。构造函数里的 required 只约束 Dart 调用方必须传参,并不能单独证明 JSON 中真的存在这个键。
更新接口要特别保留缺失状态
在 PATCH 一类局部更新中,三种状态经常有明确含义:字段缺失表示“不修改”,字段为 null 表示“清空”,空字符串表示“把值改成空字符串”。此时把字段简单建模为 String? 会丢失“是否出现”的信息,因为缺失和 null 最终都只剩一个 null。
遇到这种接口,应在解析时先记录 containsKey 的结果,或使用显式的三态封装。判断模型是否需要复杂一点,不看语法是否方便,而看业务是否真的需要区分这些状态。