SuperAPI AI 工具集

rdc-react

前端与建站

查看项目

更新于 10-16 09:48

技能介绍

该技能用于指导使用 @data-client/react 的 hooks 进行数据获取与修改。主要面向 React 应用的数据层开发,强调类型安全、自动归一化与缓存。

渲染方面,可用 useSuspense 配合资源定义发起请求并在 Suspense 下渲染;useLive 在获取后通过轮询、WebSocket 或 SSE 订阅更新;useCache 只读缓存不发起请求;useQuery 从缓存按查询读取;useDLE 返回 { data, loading, error } 不依赖 Suspense;useSubscription 单独订阅更新,通常与 useSuspense 或 useDLE 搭配。API 资源定义(如 TodoResource)需使用 rdc-rest 技能。

变更方面,通过 useController 获得 Controller,调用 ctrl.fetch 执行 update、partialUpdate、delete、push、unshift、getPage 等操作。Controller 还提供 fetchIfStale、invalidate、invalidateAll、setResponse、set、setError、resetEntireStore、subscribe、unsubscribe 等方法。

辅助 hooks 包括 useLoading 跟踪异步变更状态、useDebounce 对用户输入做防抖。组件方面推荐用 AsyncBoundary 统一处理加载与错误,其属性有 fallback、errorComponent、errorClassName、listen。自定义 Manager 可处理 WebSocket、SSE、日志等全局副作用,编写时需使用 rdc-manager 技能。

限制与注意:应根据场景选择合适 hook;处理基于用户输入渲染异步数据时建议用 useDebounce;跟踪异步变更建议用 useLoading;建议拆分为职责单一的组件。官方文档未提供的信息暂未提及。