跨平台开发 / 系统课时

区分缺失值与 null

区分缺失值与 null

接口字段缺失、值为 null、值为空字符串是三种不同输入,但直接读取 map['key'] 时前两者都会得到 null。本节用 containsKey 拆开三种状态,并据此决定字段应必填、可空、给默认值,还是保留额外状态。

学习目标

  • 区分字段缺失、值为 null 与空字符串三种输入
  • 根据接口语义选择必填、可空或默认值字段
  • 知道什么时候必须用 containsKey 保留“是否出现”这一层信息

直接取值会丢掉一层信息

Dart 的 Map 在键不存在时返回 null,键存在且值本身为 null 时也返回 null。因此只看 json['nickname'] 无法判断接口究竟省略了字段,还是明确发送了空值。

下面的程序把三种情况放在一起比较:

dart
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': '',
  });
}

预期输出:

text
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 类,用来展示解析策略,不能独立运行。

dart
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 的结果,或使用显式的三态封装。判断模型是否需要复杂一点,不看语法是否方便,而看业务是否真的需要区分这些状态。

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

目录与阅读设置

记录一个想法

区分缺失值与 null

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

登录哪都通