SAP|SAP UI5 setProperty 的执行逻辑单步调式和分析
按照 Jerry 这篇文章介绍的代码,运行之后,给类型为 sap.ui.model.type.Currency
的字段设置一个非 number
类型的值之后,触发该数据类型自带的数据校验机制,显示 Enter a number
的错误消息。
SAP UI5 应用开发教程之四十六 - 使用 Message Manager 实现开箱即用的验证(Validation)信息抛出
本文介绍 SAP UI5 ManagedObject
的 setProperty
方法的执行原理。
首先明确,什么是 ManagedObject
?
托管属性表示 ManagedObject 的状态。 它们可以存储简单数据类型(如“字符串”或“整数”)的单个值。 它们具有名称(例如“size”)和获取当前值(getSize)或设置新值(setSize)的方法。 当通过调用 setter 修改属性时,ManagedObject 被标记为无效。 可以使用 #bindProperty 方法将托管属性绑定到 sap.ui.model.Model 中的属性。 对模型属性的更新将自动反映在托管属性中,并且 - 如果 TwoWay 数据绑定处于活动状态,则对托管属性的更改将反映在模型中。 可以通过调用#unbindProperty 删除现有绑定。
文章图片
当 input 控件失去 focus 之后,触发 onsapfocusleave
,这个方法调用 onChange
:
文章图片
传入的输入参数,event
类型为 sapfocusleave
:
文章图片
如果当前最新的值和之前的值 getLastValue()
不相等,则调用 this.setValue
:
文章图片
Input.setValue 调用 InputBase.setValue:
文章图片
setValue 最终调用 setProperty,属性名称为 value
:
文章图片
正式进入 setProperty 方法,首先从 mProperties
里得到修改之前的值:
文章图片
然后进行 validateProperty
:
文章图片
【SAP|SAP UI5 setProperty 的执行逻辑单步调式和分析】validateProperty 内部,首先从 this.getMetadata().getManagedProperty(sPropertyName)
读取该 value 属性的 元数据
:
文章图片
关于 SAP UI5 控件的元数据设计,请参考我这篇文章:
深入学习SAP UI5框架代码系列之四:SAP UI5控件的元数据实现。
获得 string 类型对象:
文章图片
类型对象由一系列函数组成:
文章图片
执行 normalize 操作:
文章图片
将这个不合法的 value,设置到 this.mProperties[sPropertyName]
中。
文章图片
进行双向绑定的逻辑处理:this.updateModelProperty
文章图片
拿到绑定对象:
文章图片
进入双向绑定的处理分支:
文章图片
if (oBinding && oBinding.getBindingMode() == BindingMode.TwoWay) {
oBindingInfo.skipPropertyUpdate++;
SyncPromise.resolve(oValue).then(function(oValue) {
return oBinding.setExternalValue(oValue);
}).then(function() {
oBindingInfo.skipPropertyUpdate--;
return oBinding.getExternalValue();
}).then(function(oExternalValue) {
if (oValue != oExternalValue) {
that.updateProperty(sName);
}
handleSuccess();
}).catch(function(oException) {
oBindingInfo.skipPropertyUpdate--;
handleException(oException);
}).unwrap();
文章图片
SyncPromise.resolve(oValue).then(function(oValue) {
return oBinding.setExternalValue(oValue);
})
文章图片
在
CompositeBinding.js
内部,核心逻辑是第 325 行的代码:that.oType.parseValue(oValue, that.sInternalType, aCurrentValues);
文章图片
调用
outputFormat
进行输入值的解析工作:文章图片
推荐阅读
- SAP|SAP UI5 Currency 数据类型的校验逻辑分析
- SAP|SAP UI5 Library Resource Bundle 的设计原理
- SAP|SAP UI5 应用开发教程之四十一 - Chrome 扩展 UI5 Inspector 的离线安装和使用方法
- SAP|SAP UI5 应用开发教程之四十二 - SAP UI5 自带的 Diagnostics 诊断工具使用方法介绍
- SAP|SAP UI5 应用开发教程之四十三 - SAP UI5 自带的 Support Assistant 工具使用方法介绍
- SAP|SAP UI5 应用开发教程之四十四 - Label 和 Input 控件文本没有水平对齐的原因分析和解决方案
- 如何制作包含了|如何制作包含了 component-preload.js 在内的 SAP UI5 发布版本
- 开源工具|开源工具 @sap/ux-ui5-tooling 介绍
- SAP|SAP UI5 应用开发教程之三十九 - SAP UI5 应用出现白屏的一些常见错误和分析方法分享试读版
- 27|27 行代码开发一个最简单的 SAP ALV 报表