跨平台开发 / 系统课时
为列表状态封装增删改操作
为列表状态封装增删改操作
列表状态如果由界面直接执行 add、remove 或修改元素字段,很快会把业务规则散落到多个组件中。更合适的做法是把新增、更新和删除统一封装进 Riverpod Notifier,让界面只表达“要做什么”,而不是自己负责修改列表。
学习目标
- 能用
Notifier<List<T>>管理列表业务状态 - 能封装
add、update、remove等明确的修改接口 - 理解为什么列表更新应创建新列表和新元素对象
让 Notifier 成为唯一修改入口
以待办列表为例,界面只需要读取当前任务并调用业务操作。新增任务如何生成状态、更新时如何寻找目标、删除时如何过滤元素,都放在 Notifier 内部完成。
这样做有两个直接收益:一是所有修改规则集中在同一个位置,二是 UI 不必知道列表应该怎样复制。以后需要增加“禁止重复 ID”“完成任务不能再次编辑”等规则,也可以继续放在这些业务方法中。
实现 add、update 和 remove
下面的示例定义不可变的 Todo,再由 TodoListNotifier 对列表进行增删改。每个操作最终都给 state 赋一份新的列表。
import 'package:flutter_riverpod/flutter_riverpod.dart';
class Todo {
const Todo({
required this.id,
required this.title,
this.completed = false,
});
final int id;
final String title;
final bool completed;
Todo copyWith({
String? title,
bool? completed,
}) {
return Todo(
id: id,
title: title ?? this.title,
completed: completed ?? this.completed,
);
}
@override
String toString() => '$id:$title:$completed';
}
class TodoListNotifier extends Notifier<List<Todo>> {
@override
List<Todo> build() => const [];
void add(Todo todo) {
state = [...state, todo];
}
void update(Todo updated) {
// 保持原顺序,只替换 ID 匹配的元素。
state = [
for (final todo in state)
if (todo.id == updated.id) updated else todo,
];
}
void remove(int id) {
state = state.where((todo) => todo.id != id).toList();
}
}
final todoListProvider = NotifierProvider<TodoListNotifier, List<Todo>>(
TodoListNotifier.new,
);
void main() {
final container = ProviderContainer();
final notifier = container.read(todoListProvider.notifier);
notifier.add(const Todo(id: 1, title: '学习 Riverpod'));
notifier.add(const Todo(id: 2, title: '编写示例'));
print('新增后: ${container.read(todoListProvider)}');
final first = container.read(todoListProvider).first;
notifier.update(first.copyWith(completed: true));
print('更新后: ${container.read(todoListProvider)}');
notifier.remove(2);
print('删除后: ${container.read(todoListProvider)}');
container.dispose();
}预期输出
新增后: [1:学习 Riverpod:false, 2:编写示例:false]
更新后: [1:学习 Riverpod:true, 2:编写示例:false]
删除后: [1:学习 Riverpod:true]add 使用展开运算符把旧元素复制到新列表,再追加新元素;update 遍历旧列表,只替换 ID 匹配项;remove 则通过过滤生成新列表。三个方法都没有对原列表执行原地修改。
更新元素时同时保持对象不可变
仅仅创建新列表还不够。如果列表元素本身是可变对象,外部仍可能直接修改某个元素,例如把 completed 从 false 改成 true,而不经过 Notifier。
因此示例中的 Todo 同样使用 final 字段,并通过 copyWith 创建新元素。完成任务时先得到新的 Todo,然后调用 update 替换列表中的旧实例。列表和元素两层都采用不可变更新,状态变化才有完整边界。
明确处理不存在的目标
当前 update 在找不到对应 ID 时会保持列表内容不变,remove 找不到 ID 时同样得到等价的新列表。这种行为适合允许幂等操作的简单场景,但真实业务需要先决定“不存在”究竟意味着什么。
如果更新不存在的记录属于程序错误,可以先检查 state.any((todo) => todo.id == updated.id),再抛出异常或返回失败结果;如果数据可能被并发刷新删除,那么静默忽略也可能更合理。接口行为应由业务语义决定,而不是偶然由列表 API 决定。
当列表逻辑继续增长时,还可以把排序、去重、批量更新等规则继续封装在 Notifier 中。界面始终只通过有限的业务方法修改状态,就能避免多个 Widget 各自实现一套增删改逻辑。