按照 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
:
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
进行输入值的解析工作: