跨平台开发 / 系统课时
使用 Records 组合轻量数据
使用 Records 组合轻量数据
当一个函数需要一次返回多个不同类型的结果,而这些值只在局部流程中短暂使用时,Dart Records 可以省掉临时类和松散集合。本篇用位置字段、命名字段和解构完成一个可运行示例,并说明 Records 的结构类型边界。
学习目标
- 创建包含位置字段和命名字段的 Record,并正确读取字段。
- 理解 Record 的结构类型由字段形状决定,而不是由声明名称决定。
- 使用解构接收多个结果,并判断 Record 与类、集合的适用边界。
创建位置字段与命名字段
Record 是固定字段数量、可混合字段类型的不可变聚合值。位置字段按顺序确定位置,可通过 $1、$2 等 getter 读取;命名字段把名称写进记录形状,可通过同名 getter 读取。下面的 typedef 只是给记录形状起可读别名,不会创建一个新的名义类型。
typedef ScoreResult = ({String name, int score});
ScoreResult buildResult(String name, int score) {
return (name: name, score: score);
}
void main() {
(String, int) positional = ('Ada', 95);
ScoreResult first = buildResult('Ada', 95);
// 命名字段的书写顺序不决定类型,字段名和字段类型才是形状的一部分。
({int score, String name}) sameShape = (score: 88, name: 'Lin');
ScoreResult second = sameShape;
final (:name, :score) = first;
print('${positional.$1}:${positional.$2}');
print('$name:$score');
print('${second.name}:${second.score}');
}预期输出
Ada:95
Ada:95
Lin:88位置字段适合含义由顺序自然表达的短结果,例如二维坐标;一旦调用者需要记住“第二个值到底是什么”,命名字段通常更清楚。
理解结构类型
Record 没有独立的类声明。它的静态类型由字段数量、位置字段的类型,以及命名字段的名称和类型共同决定。两个互不相关的函数只要返回相同形状的 Record,类型系统就可以把它们视为兼容类型。
命名字段的顺序不属于形状,因此示例中的 ({int score, String name}) 可以赋给 ScoreResult。相反,如果把 score 改名为 points,即使两个字段的值和类型完全相同,也会成为不同的记录形状。位置字段在类型标注中写出的说明性名称不参与类型判断。
用解构接收多个结果
当函数返回 Record 时,模式解构可以在接收结果的同时创建局部变量。示例中的 final (:name, :score) = first; 按命名字段匹配,并生成 name 与 score 两个变量;位置 Record 则可以使用 final (x, y) = record; 按位置拆开。
解构特别适合“一个计算产生多个紧密相关结果”的场景,因为调用点直接暴露每个值的含义,不必先保存整个对象再逐个访问 getter。Record 本身仍然不可变,不能在创建后给某个字段重新赋值。
判断何时改用类
Record 适合局部、短生命周期、字段固定且不需要行为的组合数据,例如解析函数返回“值与是否命中”、计算函数返回“最小值与最大值”。与 List<Object?> 或 Map<String, Object?> 相比,它能让编译器保留每个字段的静态类型和结构约束。
如果数据具有稳定的领域名称、需要方法或校验规则、会跨模块长期传递,或者未来很可能扩展行为,类通常更合适。Record 的优势是轻量,而不是替代所有数据模型;当“这组字段代表什么对象”本身已经成为重要概念时,就应该给它一个明确的类。