按照 Jerry 这篇文章介绍的代码,运行之后,给类型为 sap.ui.model.type.Currency 的字段设置一个非 number 类型的值之后,触发该数据类型自带的数据校验机制,显示 Enter a number 的错误消息。

SAP UI5 应用开发教程之四十六 - 使用 Message Manager 实现开箱即用的验证(Validation)信息抛出

本文介绍 SAP UI5 ManagedObjectsetProperty 方法的执行原理。

首先明确,什么是 ManagedObject

托管属性表示 ManagedObject 的状态。 它们可以存储简单数据类型(如“字符串”或“整数”)的单个值。 它们具有名称(例如“size”)和获取当前值(getSize)或设置新值(setSize)的方法。 当通过调用 setter 修改属性时,ManagedObject 被标记为无效。 可以使用 #bindProperty 方法将托管属性绑定到 sap.ui.model.Model 中的属性。 对模型属性的更新将自动反映在托管属性中,并且 - 如果 TwoWay 数据绑定处于活动状态,则对托管属性的更改将反映在模型中。 可以通过调用#unbindProperty 删除现有绑定。
SAP UI5 setProperty 的执行逻辑单步调式和分析

当 input 控件失去 focus 之后,触发 onsapfocusleave,这个方法调用 onChange

SAP UI5 setProperty 的执行逻辑单步调式和分析

传入的输入参数,event 类型为 sapfocusleave

SAP UI5 setProperty 的执行逻辑单步调式和分析

如果当前最新的值和之前的值 getLastValue() 不相等,则调用 this.setValue

SAP UI5 setProperty 的执行逻辑单步调式和分析

Input.setValue 调用 InputBase.setValue:

SAP UI5 setProperty 的执行逻辑单步调式和分析

setValue 最终调用 setProperty,属性名称为 value

SAP UI5 setProperty 的执行逻辑单步调式和分析

正式进入 setProperty 方法,首先从 mProperties 里得到修改之前的值:

SAP UI5 setProperty 的执行逻辑单步调式和分析

然后进行 validateProperty

SAP UI5 setProperty 的执行逻辑单步调式和分析

validateProperty 内部,首先从 this.getMetadata().getManagedProperty(sPropertyName) 读取该 value 属性的 元数据

SAP UI5 setProperty 的执行逻辑单步调式和分析

关于 SAP UI5 控件的元数据设计,请参考我这篇文章:

深入学习SAP UI5框架代码系列之四:SAP UI5控件的元数据实现

获得 string 类型对象:

SAP UI5 setProperty 的执行逻辑单步调式和分析

类型对象由一系列函数组成:
SAP UI5 setProperty 的执行逻辑单步调式和分析

执行 normalize 操作:

SAP UI5 setProperty 的执行逻辑单步调式和分析

将这个不合法的 value,设置到 this.mProperties[sPropertyName] 中。

SAP UI5 setProperty 的执行逻辑单步调式和分析

进行双向绑定的逻辑处理:this.updateModelProperty

SAP UI5 setProperty 的执行逻辑单步调式和分析

拿到绑定对象:

SAP UI5 setProperty 的执行逻辑单步调式和分析

进入双向绑定的处理分支:

SAP UI5 setProperty 的执行逻辑单步调式和分析

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();

SAP UI5 setProperty 的执行逻辑单步调式和分析

SyncPromise.resolve(oValue).then(function(oValue) {
                    return oBinding.setExternalValue(oValue);
                })

SAP UI5 setProperty 的执行逻辑单步调式和分析

CompositeBinding.js 内部,核心逻辑是第 325 行的代码:

that.oType.parseValue(oValue, that.sInternalType, aCurrentValues);

SAP UI5 setProperty 的执行逻辑单步调式和分析

调用 outputFormat 进行输入值的解析工作:

SAP UI5 setProperty 的执行逻辑单步调式和分析