在 React 中用 Syncfusion…

当需要为 React 应用接入本地数组或远程 REST/OData/GraphQL 数据源，并实现过滤、排序、分页、分组、CRUD、缓存、离线或请求中间件时，用 DataManager 作为数据网关。

适用场景

解决思路

1. 当用户提供 service URL 但未明确指定 adaptor 类型时，立即停止生成代码，阅读 references/adaptor-decision-gate.md，按模板向用户展示 adaptor 选择门，等待用户明确确认后再生成 DataManager 代码。
2. 判断是否需要 adaptor 决策门：若用户只说“API”“REST”或给出 URL 未指定 adaptor，则需要；若明确说 OData v4、WebApiAdaptor 返回 { Items, Count } 或本地绑定，则不需要。
3. 用 json 属性绑定本地 JavaScript 数组，用 url 属性绑定远程 API；本地查询调用 executeLocal()，远程查询调用 executeQuery()。
4. 用 Query 类链式构建查询：from()、where()、select()、sortBy()、take()、expand()、group() 组合实现过滤、排序、分页、字段投影、关联加载和分组。
5. 根据数据源选择 adaptor：JsonAdaptor 用于本地数组，ODataAdaptor 用于 OData v3，ODataV4Adaptor 用于 OData v4，UrlAdaptor 用于通用 REST，WebApiAdaptor 用于 ASP.NET Web API，RemoteSaveAdaptor 用于客户端查询加服务端 CRUD 的混合模式，WebMethodAdaptor 用于旧版 ASP.NET ASMX，GraphQLAdaptor 用于 GraphQL，CustomAdaptor 用于专有服务。
6. 执行 CRUD：insert() 新增记录，update() 修改记录（keyField 作为第一个参数），remove() 删除记录（keyField 作为第一个参数），saveChanges() 将多个操作批量合并为单个请求。
7. 用 applyPreRequestMiddlewares() 在发送前修改请求（注入 auth token、自定义 header），用 applyPostRequestMiddlewares() 在绑定前转换响应（格式化、过滤），并配置错误处理函数处理请求失败。
8. 用 enableCache 缓存已加载页面避免重复请求；实现离线模式将数据存本地并在连接恢复后同步；用按需加载/虚拟滚动懒加载数据；用 Promise 与 async/await 处理延迟操作。
9. 远程绑定时强制安全措施：仅使用 HTTPS；将端点赋给私有字符串变量而非在标记中硬编码；对响应做服务端 schema 校验并映射到强类型模型；记录所有外部 API 请求的时间戳、端点和结果；CORS 仅允许特定可信来源，生产环境禁止通配符 *；验证端点归属、实现请求签名、校验响应内容类型和 schema 以防间接提示注入。
10. 按任务查阅参考文档：安装与初始化看 getting-started.md，数据绑定看 data-binding.md，查询过滤看 querying-and-filtering.md，CRUD 看 crud-operations.md，adaptor 选择看 adaptors-guide.md，中间件看 middleware-customization.md，缓存离线看 caching-offline-mode.md，高级模式看 advanced-features.md。
11. 按常见场景选型：本地过滤用 JsonAdaptor + Query + where()；带认证的服务端数据用 WebApiAdaptor + applyPreRequestMiddlewares()；离线后同步用 enableCache + offline + saveChanges()；嵌套关联数据用 ODataV4Adaptor 或 RemoteSaveAdaptor + expand()；GraphQL 后端用 GraphQLAdaptor 加自定义查询构建器；旧版 ASMX 用 WebMethodAdaptor 并做响应映射。
12. 在 DataManager 与直接组件绑定之间取舍：需要灵活切换数据源、复杂查询、完整 CRUD、中间件、缓存或离线时用 DataManager；只需基础绑定、超大数据集性能优先或不需要中间件时用直接绑定。

适用边界 · 注意事项

• 只需要基础数据绑定、没有复杂查询或离线需求时，直接组件绑定更简单。
• 数据集非常大且性能极度敏感、又不需要中间件定制时，直接绑定可能更合适。
• 未确认 adaptor 类型前不要生成远程 DataManager 代码，必须先通过 adaptor 决策门获得用户确认。