0
点赞
收藏
分享

微信扫一扫

关于 SAP UI5 参数 $$updateGroupId 前面两个 $ 符号的含义

大明宫 2022-06-27 阅读 89

我的 SAP UI5 教程,SAP UI5 应用开发教程之六十五 - 基于 OData V4 的 SAP UI5 表格控件如何实现创建,编辑和保存功能​,里面演示了通过 XML 视图的方式,非 SAP UI5 ​​Table​​ 控件,定义复合绑定路径的语法,如下图所示:

关于 SAP UI5 参数 $$updateGroupId 前面两个 $ 符号的含义_xml

<Table
id="peopleList"
growing="true"
growingThreshold="10"
items="{
path: '/People',
parameters: {
$count: true,
$$updateGroupId : 'peopleGroup'
}
}">

这行语句的语义是:当用户修改(update)表格行项目时,表格控件不会立即将这些修改,通过 HTTP Post 请求的方式发送到提供 OData 服务的 Mock Server,而是延迟到当用户点击工具栏的 Save 按钮时才发送 HTTP Post Batch 请求,进行修改的保存。peopleGroup 是 Batch 请求的 group 编号,可以在 Chrome 开发者工具里观察到:

关于 SAP UI5 参数 $$updateGroupId 前面两个 $ 符号的含义_html_02

有朋友对于 XML 视图里的参数 ​​$$updateGroupId​​ 提出这样的疑问:


这个updateGroupId前面是两个$符号,而count前面是一个$,这个含义能给解释一下吗?啥时候是一个,啥时候是两个?


关于 SAP UI5 参数 $$updateGroupId 前面两个 $ 符号的含义_表格控件_03

其实答案很简单:

  1. 带有​​单个​​ $ 符号的操作,代表这是 OData 协议支持的标准操作。

从 OData 协议的​​官网​​ 上可以找到所有这些标准操作的列表,比如:

  • $search
  • $filter
  • $count
  • $orderby
  • $skip
  • $top
    等等。

关于 SAP UI5 参数 $$updateGroupId 前面两个 $ 符号的含义_xml_04

以两个 ​​$$​​ 开头的操作,说明是 SAP 引入的自定义参数,用以同 OData 协议标准的操作相区分。

这个道理其实和 SAP UI5 ​​index.html​​​ 页面里,id 为 ​​sap-ui-bootstrap​​​ 的引导 script 元素里,有大量 ​​data-sap-XXXX​​​ 属性定义的道理一样。这些属性用 ​​data-sap​​ 开头,也是为了避免和 HTML 标准的属性相冲突的可能性。

关于 SAP UI5 参数 $$updateGroupId 前面两个 $ 符号的含义_html_05

OData V4 模型支持为 read, update 和 delete 操作分别指定不同的 group ID. 调用 OData Model API 提交的更改请求,会根据 group ID 合并到同一个批处理请求中。

关于 group id 字段的更多细节,请参考这两篇文章:

  • 关于 SAP UI5 Context.prototype.delete 方法的输入参数 Group ID 的细节
  • SAP UI5 OData V4 模型的构造方式
举报

相关推荐

关于 SAP UI5 Web Components

0 条评论