async.zh-CN.md

async 基于 rx.js 封装而来，目的是以统一的接口响应应用中的各种异步事件，如网络，消息，服务器推送等等, 并提供基本的防抖、超时，可取消等特性。

每一个 logic.js 文件都会引入 sr71 模块：

import { asyncSuit } from '@/utils'

const { SR71 } = asyncSuit
const sr71$ = new SR71()

备注: sr71 为美军黑鸟侦察机的代号:

网络事件

你可以在函数中调用网络请求, query 和 mutate 分别代表 GraphQL 中的 query 和 mutate 操作

sr71$.query(S.pagedPosts, args)
// or
sr71$.mutate(S.updateProfile, args)

对应的，在 DataSolver 中响应服务器返回的数据(DataSover 会由 make gen 生成器自动生成):

const DataSolver = [
  {
    match: asyncRes('updateProfile'),
    action: () => {
      updateDone()
      cancelLoading()
    },
  },
]

异步消息

容器组件可以在初始化的时候监听需要响应的异步事件，比如：

const sr71$ = new SR71({
  receive: [
    EVENT.DRAWER.OPEN,
    EVENT.DRAWER.CLOSE,
    EVENT.UPLOAD_IMG_START,
    EVENT.UPLOAD_IMG_FINISH,
  ],
})

代表该容器组件接收 4 个消息， 分别是 EVENT.DRAWER.OPEN, EVENT.DRAWER.CLOSE, EVENT.UPLOAD_IMG_START, EVENT.UPLOAD_IMG_FINISH

对应的 DataSolver:

{
    match: asyncRes(EVENT.DRAWER.OPEN),
    action: res => {
      const payload = res[EVENT.DRAWER.OPEN]
      lockPage()

      store.open(payload)
    },
  },
  {
    match: asyncRes(EVENT.DRAWER.CLOSE),
    action: () => closeDrawer(),
  },
  {
    match: asyncRes(EVENT.UPLOAD_IMG_START),
    action: () => store.mark({ imageUploading: true }),
  },
  {
    match: asyncRes(EVENT.UPLOAD_IMG_FINISH),
    action: () => {
      setTimeout(() => {
        store.mark({ imageUploading: false })
      }, 500)
    },
  },

推送事件

与之类似， TODO

错误处理

错误处理的逻辑统一由 ErrSolver 内，以统一的方式分别响应 GraphQL 解析错误，请求错误，超时错误，网络错误等等。errRescue为全局的错误提示、显示组件(详情), 同时出错后一些组件内部的状态，如 loading 等等，也在这里处理。

const ErrSolver = [
  {
    match: asyncErr(ERR.GRAPHQL),
    action: () => cancelLoading(),
  },
  {
    match: asyncErr(ERR.TIMEOUT),
    action: ({ details }) => {
      cancelLoading()
      errRescue({ type: ERR.TIMEOUT, details, path: 'AccountEditor' })
    },
  },
  {
    match: asyncErr(ERR.NETWORK),
    action: () => {
      cancelLoading()
      errRescue({ type: ERR.NETWORK, path: 'AccountEditor' })
    },
  },
]