共享的状态管理模式

初始状态

首次创建 store 时,它为空。然后,可以使用一个 process 为 store 填充初始的应用程序状态。

main.ts

  1. const store = new Store<State>();
  2. const { path } = store;
  3. const createCommand = createCommandFactory<State>();
  4. const initialStateCommand = createCommand(({ path }) => {
  5. return [add(path('auth'), { token: undefined }), add(path('users'), { list: [] })];
  6. });
  7. const initialStateProcess = createProcess('initial', [initialStateCommand]);
  8. initialStateProcess(store)({});

Undo

Dojo store 使用 patch operation 跟踪底层 store 的变化。这样,Dojo 就很容易创建一组 operation,然后撤销这组 operation,以恢复一组 command 所修改的任何数据。undoOperationsProcessResult 的一部分,可在 after 中间件中使用。

当一个 process 包含了多个修改 store 状态的 command,并且其中一个 command 执行失败,需要回滚时,撤销(Undo) operation 非常有用。

undo middleware

  1. const undoOnFailure = () => {
  2. return {
  3. after: () => (error, result) {
  4. if (error) {
  5. result.store.apply(result.undoOperations);
  6. }
  7. }
  8. };
  9. };
  10. const process = createProcess('do-something', [
  11. command1, command2, command3
  12. ], [ undoOnFailure ])

在执行时,任何 command 出错,则 undoOnFailure 中间件就负责应用 undoOperations

需要注意的是,undoOperations 仅适用于在 process 中完全执行的 command。在回滚状态时,它将不包含以下任何 operation,这些状态的变更可能是异步执行的其他 process 引起的,或者在中间件中执行的状态变更,或者直接在 store 上操作的。这些用例不在 undo 系统的范围内。

乐观更新

乐观更新可用于构建响应式 UI,尽管交互可能需要一些时间才能响应,例如往远程保存资源。

例如,假使正在添加一个 todo 项,通过乐观更新,可以在向服务器发送持久化对象的请求之前,就将 todo 项添加到 store 中,从而避免尴尬的等待期或者加载指示器。当服务器响应后,可以根据服务器操作的结果成功与否,来协调 store 中的 todo 项。

在成功的场景中,使用服务器响应中提供的 id 来更新已添加的 Todo 项,并将 Todo 项的颜色改为绿色,以指示已保存成功。

在出错的场景中,可以显示一个通知,说明请求失败,并将 Todo 项的颜色改为红色,同时显示一个“重试”按钮。甚至可以恢复或撤销添加的 Todo 项,以及在 process 中发生的其他任何操作。

  1. const handleAddTodoErrorProcess = createProcess('error', [ () => [ add(path('failed'), true) ]; ]);
  2. const addTodoErrorMiddleware = () => {
  3. return {
  4. after: () => (error, result) {
  5. if (error) {
  6. result.store.apply(result.undoOperations);
  7. result.executor(handleAddTodoErrorProcess);
  8. }
  9. }
  10. };
  11. };
  12. const addTodoProcess = createProcess('add-todo', [
  13. addTodoCommand,
  14. calculateCountsCommand,
  15. postTodoCommand,
  16. calculateCountsCommand
  17. ],
  18. [ addTodoCallback ]);
  • addTodoCommand - 在应用程序状态中添加一个 todo 项
  • calculateCountsCommand - 重新计算已完成的待办项个数和活动的待办项个数
  • postTodoCommand - 将 todo 项提交给远程服务,并使用 process 的 after 中间件在发生错误时执行进一步更改
    • 失败时 将恢复更改,并将 failed 状态字段设置为 true
    • 成功时 使用从远程服务返回的值更新 todo 项的 id 字段
  • calculateCountsCommand - postTodoCommand 成功后再运行一次

同步更新

在某些情况下,在继续执行 process 之前,最好等后端调用完成。例如,当 process 从屏幕中删除一个元素时,或者 outlet 发生变化要显示不同的视图,恢复触发这些操作的状态可能会让人感到很诡异(译注:数据先从界面上删掉了,因为后台删除失败,过一会数据又出现在界面上)。

因为 process 支持异步 command,只需简单的返回 Promise 以等待结果。

  1. function byId(id: string) {
  2. return (item: any) => id === item.id;
  3. }
  4. async function deleteTodoCommand({ get, payload: { id } }: CommandRequest) {
  5. const { todo, index } = find(get('/todos'), byId(id));
  6. await fetch(`/todo/${todo.id}`, { method: 'DELETE' });
  7. return [remove(path('todos', index))];
  8. }
  9. const deleteTodoProcess = createProcess('delete', [deleteTodoCommand, calculateCountsCommand]);

并发 command

Process 支持并发执行多个 command,只需将这些 command 放在一个数组中即可。

process.ts

  1. createProcess('my-process', [commandLeft, [concurrentCommandOne, concurrentCommandTwo], commandRight]);

本示例中,commandLeft 先执行,然后并发执行 concurrentCommandOneconcurrentCommandTwo。当所有的并发 command 执行完成后,就按需应用返回的结果。如果任一并发 command 出错,则不会应用任何操作。最后,执行 commandRight

可替换的状态实现

当实例化 store 时,会默认使用 MutableState 接口的实现。在大部分情况下,默认的状态接口都经过了很好的优化,足以适用于常见情况。如果一个特殊的用例需要另一个实现,则可以在初始化时传入该实现。

  1. const store = new Store({ state: myStateImpl });

MutableState API

任何 State 实现都必须提供四个方法,以在状态上正确的应用操作。

  • get<S>(path: Path<M, S>): S 接收一个 Path 对象,并返回当前状态中该 path 指向的值
  • at<S extends Path<M, Array<any>>>(path: S, index: number): Path<M, S['value'][0]> 返回一个 Path 对象,该对象指向 path 定位到的数组中索引为 index 的值
  • path: StatePaths<M> 以类型安全的方式,为状态中给定的 path 生成一个 Path 对象
  • apply(operations: PatchOperation<T>[]): PatchOperation<T>[] 将提供的 operation 应用到当前状态上

ImmutableState

Dojo Store 通过 Immutable 为 MutableState 接口提供了一个实现。如果对 store 的状态做频繁的、较深层级的更新,则这个实现可能会提高性能。在最终决定使用这个实现之前,应先测试和验证性能。

Using Immutable

  1. import State from './interfaces';
  2. import Store from '@dojo/framework/stores/Store';
  3. import Registry from '@dojo/framework/widget-core/Registry';
  4. import ImmutableState from '@dojo/framework/stores/state/ImmutableState';
  5. const registry = new Registry();
  6. const customStore = new ImmutableState<State>();
  7. const store = new Store<State>({ store: customStore });

本地存储

Dojo Store 提供了一组工具来使用本地存储(local storage)。

本地存储中间件监视指定路径上的变化,并使用 collector 中提供的 id 和 path 中定义的结构,将它们存储在本地磁盘上。

使用本地存储中间件:

  1. export const myProcess = createProcess(
  2. 'my-process',
  3. [command],
  4. collector('my-process', (path) => {
  5. return [path('state', 'to', 'save'), path('other', 'state', 'to', 'save')];
  6. })
  7. );

来自 LocalStorage 中的 load 函数用于与 store 结合

与状态结合:

  1. import { load } from '@dojo/framework/stores/middleware/localStorage';
  2. import { Store } from '@dojo/framework/stores/Store';
  3. const store = new Store();
  4. load('my-process', store);

注意,数据要能够被序列化以便存储,并在每次调用 process 后都会覆盖数据。此实现不适用于不能序列化的数据(如 DateArrayBuffer)。