跨平台开发 / 系统课时
用不可变对象保存复杂状态
用不可变对象保存复杂状态
当一个页面同时维护名称、积分、标签等多个字段时,直接修改同一个对象很容易让状态变化变得隐蔽。更稳妥的做法是让状态对象保持不可变,每次修改都通过 copyWith 创建新对象,再把新对象交给 Riverpod 的 Notifier。
学习目标
- 理解为什么复杂业务状态应优先使用不可变对象
- 能为状态类实现
copyWith并通过Notifier替换状态 - 能避免集合字段被外部引用继续修改的问题
为什么不要原地修改状态对象
假设用户资料同时包含名称、积分和标签。若这些字段可以被任意代码直接改写,调用方可能持有同一个对象引用,某处修改后,其他位置看到的数据也会悄然变化。这样的修改没有明确的“旧状态 → 新状态”边界,调试和测试都会变困难。
不可变状态的核心规则很简单:对象创建后不再修改已有字段。业务操作根据旧状态计算一个新对象,然后执行 state = 新对象。这样每次状态变化都有清晰的新旧实例边界,也更符合 Riverpod 根据状态赋值通知监听者的使用方式。
用 copyWith 创建新状态
下面用一个完整示例管理用户资料。状态类的字段全部声明为 final,copyWith 只替换调用者明确提供的字段,其余字段沿用旧值。
import 'package:flutter_riverpod/flutter_riverpod.dart';
class UserProfileState {
const UserProfileState({
required this.name,
required this.points,
required this.tags,
});
final String name;
final int points;
final List<String> tags;
UserProfileState copyWith({
String? name,
int? points,
List<String>? tags,
}) {
return UserProfileState(
name: name ?? this.name,
points: points ?? this.points,
tags: tags ?? this.tags,
);
}
@override
String toString() =>
'UserProfileState(name: $name, points: $points, tags: $tags)';
}
class UserProfileNotifier extends Notifier<UserProfileState> {
@override
UserProfileState build() {
return const UserProfileState(
name: 'Alice',
points: 0,
tags: [],
);
}
void addPoints(int value) {
state = state.copyWith(points: state.points + value);
}
void addTag(String tag) {
// 同时创建新的 List,避免复用旧集合后再进行原地修改。
state = state.copyWith(tags: [...state.tags, tag]);
}
}
final userProfileProvider =
NotifierProvider<UserProfileNotifier, UserProfileState>(
UserProfileNotifier.new,
);
void main() {
final container = ProviderContainer();
print('初始: ${container.read(userProfileProvider)}');
final notifier = container.read(userProfileProvider.notifier);
notifier.addPoints(10);
notifier.addTag('vip');
print('更新后: ${container.read(userProfileProvider)}');
container.dispose();
}预期输出
初始: UserProfileState(name: Alice, points: 0, tags: [])
更新后: UserProfileState(name: Alice, points: 10, tags: [vip])这里真正重要的不是 copyWith 这个方法名,而是每次操作都产生一个新的 UserProfileState。addPoints 没有执行 state.points += 10,addTag 也没有对旧列表调用 add,而是构造新的值后整体替换 state。
集合字段也要保持不可变更新
对象字段是 final 并不意味着内部集合自动不可变。final List<String> 只能保证变量不能重新指向另一份列表,却仍可能对列表本身调用 add、remove 等方法。
因此更新集合字段时,应创建新集合,例如 [...state.tags, tag]。如果状态对象还会暴露给业务层之外的代码,并且需要更严格地阻止外部修改,还可以在构造阶段保存不可修改视图或使用专门的不可变集合类型。
copyWith 的一个重要边界
上面的 copyWith 使用 name ?? this.name 这类写法,因此适用于字段本身不需要保存 null 的场景。如果某个字段声明为可空类型,并且业务需要明确地把它更新为 null,就需要使用额外哨兵值、专门参数或代码生成方案来区分“没有传参”和“主动设置为 null”。
对于字段数量较少的状态,手写 copyWith 足够直接;字段越来越多时,可以考虑使用支持不可变模型与代码生成的工具减少样板代码。无论采用哪种实现方式,关键约束都不变:读取旧状态、创建新值、一次性替换 state,不要让业务逻辑依赖共享可变对象。