用途:指导在 SAPUI5 应用中使用 OData V4 数据绑定,适合采用 CAP 或 S/4HANA Cloud 的新项目。资料建议新应用始终使用 sap.ui.model.odata.v4.ODataModel,V2 为遗留方案,会失去批量优化、副作用与 Fiori Elements 的深度集成。
主要能力:通过 ODataModel#bindList 获取列表绑定并读取集合;用 bindContext 绑定单个实体;用 requestContexts 返回上下文并配合 getObject 同步读取;用 requestObject 读取单实体;用 setProperty 修改属性并用 submitBatch("$auto") 提交;用列表绑定的 create 创建实体并通过 created() 等待服务端确认;用上下文 delete("$auto") 删除实体。支持 $auto、$direct 与自定义 group ID 的批处理控制,并可通过 requestSideEffects 在动作后刷新指定属性或导航属性。模型可在 manifest.json 的 sap.ui5.models 中配置,示例设置包括 synchronizationMode、operationMode、autoExpandSelect、earlyRequests。
必要用法:读取前需 await requestObject() 或 await requestContexts();自定义组需手动 submitBatch();CAP 中可用 CDS 注解 Common.SideEffects 声明副作用目标。
限制与常见错误:不要在数据加载前调用 getObject();不要手动 submitBatch("$auto");不要用刷新整个模型代替副作用;V4 绑定行为与 V2 的 filter/sort API 不同,应查阅 V4 文档。原文其余 API 细节与完整示例未在资料中展开。