跨平台开发 / 系统课时

为列表状态封装增删改操作

为列表状态封装增删改操作

列表状态如果由界面直接执行 add、remove 或修改元素字段,很快会把业务规则散落到多个组件中。更合适的做法是把新增、更新和删除统一封装进 Riverpod Notifier,让界面只表达“要做什么”,而不是自己负责修改列表。

学习目标

  • 能用 Notifier<List<T>> 管理列表业务状态
  • 能封装 add、update、remove 等明确的修改接口
  • 理解为什么列表更新应创建新列表和新元素对象

让 Notifier 成为唯一修改入口

以待办列表为例,界面只需要读取当前任务并调用业务操作。新增任务如何生成状态、更新时如何寻找目标、删除时如何过滤元素,都放在 Notifier 内部完成。

这样做有两个直接收益:一是所有修改规则集中在同一个位置,二是 UI 不必知道列表应该怎样复制。以后需要增加“禁止重复 ID”“完成任务不能再次编辑”等规则,也可以继续放在这些业务方法中。

实现 add、update 和 remove

下面的示例定义不可变的 Todo,再由 TodoListNotifier 对列表进行增删改。每个操作最终都给 state 赋一份新的列表。

dart
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();
}

预期输出

text
新增后: [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 各自实现一套增删改逻辑。

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

目录与阅读设置

阅读设置

17

记录一个想法

为列表状态封装增删改操作

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

登录哪都通