likes
comments
collection

关于 SAP UI5 Context.prototype.delete 方法的输入参数 Group

作者站长头像
站长
· 阅读数 6

在 Jerry 这篇教程 SAP UI5 应用开发教程之六十六 - 基于 OData V4 的 SAP UI5 表格控件如何实现删除功能 里,有个朋友提了个问题:

关于 SAP UI5 Context.prototype.delete 方法的输入参数 Group

我们选中列表行项目之后,点击删除按钮,会触发一个 OData 的删除请求:

关于 SAP UI5 Context.prototype.delete 方法的输入参数 Group

这个删除请求,通过 onDelete 函数的第 62 行代码,调用 BindingContext 实例的 delete 方法触发。该 delete 方法的输入参数为 $auto, 这个字符串代表什么含义?

关于 SAP UI5 Context.prototype.delete 方法的输入参数 Group

老规矩,我们可以通过 Chrome 开发者工具的单步调试来了解这个参数的含义:Group ID.

关于 SAP UI5 Context.prototype.delete 方法的输入参数 Group

也可以在官方文档 里找到 delete 方法的参数定义:

关于 SAP UI5 Context.prototype.delete 方法的输入参数 Group

这个参数代表删除请求的 Group ID,$auto 是默认值。

在 Context.js 的 delete 实现里,会调用 OData model 实例的 checkGroupId 方法,对该传进来的值进行一个校验:

关于 SAP UI5 Context.prototype.delete 方法的输入参数 Group

group id 是 SAP UI5 框架用来标识和管理 OData Batch Request (批处理请求)的字段之一,参看文档

关于 SAP UI5 Context.prototype.delete 方法的输入参数 Group

group id 允许的值有 $auto, $auto.*$direct 几种情况。$auto 的含义就是默认的行为,即将通过 OData Model 实例调用 API 触发的请求,以批处理的请求模式发送给 OData 服务器。$direct 则代表不使用批处理模式发送请求。

关于什么是 OData 请求的批处理发送模式,Jerry 在我这篇文章里已经详细介绍过:

SAP UI5 应用开发教程之六十三 - 基于 OData V4 的本地 Mock Server 实现的深入介绍

Context 会把 delete 操作 delegate 到 Binding 实例的 _delete 方法去执行。关于 SAP UI5 Context.prototype.delete 方法的输入参数 Group

在绝大部分情况下,我们调用 BindingContext 的 delete 方法时,传入默认的 group id 即 $auto 即可。

这也是为什么 SAP 绝大多数的帮助文档里,给出的删除功能的实现示例代码里,都采用该默认值的原因:

关于 SAP UI5 Context.prototype.delete 方法的输入参数 Group

当然我们也可以在应用程序里自定义 group id,具体例子参考笔者这篇文章:

SAP UI5 OData V4 模型的构造方式