揭开SAP Fiori编程模型规范里注解的神秘面纱 - @ObjectModel

今天是农历鼠年大年初五,本文是鼠年第5篇文章,也是汪子熙公众号第204篇原创文章。


最近大家真是谈蝙蝠色变呀!


揭开SAP Fiori编程模型规范里注解的神秘面纱 - @ObjectModel


揭开SAP Fiori编程模型规范里注解的神秘面纱 - @ObjectModel


SAP官网的ABAP Programming Model for Fiori帮助文档里,定义了很多注解(Annotation):

https://help.sap.com/viewer/cc0c305d2fab47bd808adcad3ca7ee9d/1709%20000/en-US/896496ecfe4f4f8b857c6d93d4489841.html

揭开SAP Fiori编程模型规范里注解的神秘面纱 - @ObjectModel



对于这些注解,我们可以从其字面含义和SAP帮助文档去掌握其用法和功能。

揭开SAP Fiori编程模型规范里注解的神秘面纱 - @ObjectModel



以@ObjectModel.readOnly为例,施加了这个注解的CDS view字段,在对应的Fiori UI上以只读的方式渲染:

揭开SAP Fiori编程模型规范里注解的神秘面纱 - @ObjectModel



并且也不能通过编程的方式进行修改。


揭开SAP Fiori编程模型规范里注解的神秘面纱 - @ObjectModel


大家在使用这些注解的时候,有没有想过,它们是怎么工作的?


以@ObjectModel.readOnly为例,现在就请跟着Jerry一起,去探索它的前后台实现原理。


在Chrome开发者工具的UI5面板里,找到Posting Date这个控件对应的属性,发现字段editable属性值为false,这就是其在UI不能编辑的原因。


如果你的Chrome开发者工具没有UI5这个标签,请参考Jerry这篇文章,安装Chrome for UI5的扩展:


Jerry的Fiori原创文章合集


揭开SAP Fiori编程模型规范里注解的神秘面纱 - @ObjectModel


既然后台模型是CDS view,那么前台UI显然基于Fiori Elements. 我想知道Posting Date这个控件的editable属性是在什么时候被设置成false的。


在SmartField.setEditable函数里设置断点,重新打开Fiori UI,点击Edit进入编辑模型,断点触发,从调用栈能看出,有代码调用SmartField.setEditable时,传入的参数为false.


揭开SAP Fiori编程模型规范里注解的神秘面纱 - @ObjectModel


那么这个false如何计算出来的?顺着当前的调用栈往外层查找,发现一个重要的函数:


AnnotationHelper.canUpdateProperty.


从函数名就能猜测出,这个函数负责计算一个控件的属性是否允许更新(Update),工作的上下文就是注解(Annotation).

揭开SAP Fiori编程模型规范里注解的神秘面纱 - @ObjectModel



这个方法实现体的语义也很清楚,如果后台模型字段sap:updatable设置为false,则canUpdateProperty函数调用返回false,导致SmartField.setEditable以参数false去渲染Fiori UI.


我们打开OData服务的metadata,发现posting date字段对应的sap:updatable果然为false.


揭开SAP Fiori编程模型规范里注解的神秘面纱 - @ObjectModel


至此Fiori UI的工作原理分析完毕。我们再来看后台。我的CDS view里只添加了@ObjectModel.readOnly为true的注解,而非sap:updatable. 显然,这二者存在一定的关联关系。


在Jerry之前的文章 Jerry的CDS view自学系列 介绍过CDS view框架处理逻辑,有这么一段代码:

揭开SAP Fiori编程模型规范里注解的神秘面纱 - @ObjectModel



第839行的IF判断,如果OBJECTMODEL.READONLY为true,则read_only属性为X.


而read_only属性为true,会导致posting date字段的属性集合内表里,新增一条read_only为X的记录:


揭开SAP Fiori编程模型规范里注解的神秘面纱 - @ObjectModel揭开SAP Fiori编程模型规范里注解的神秘面纱 - @ObjectModel



最后,在SADL框架的属性检测逻辑中,一旦发现字段属性集合内表里存在read_only为X的属性,则将lv_creatable和lv_updatable置为false.


揭开SAP Fiori编程模型规范里注解的神秘面纱 - @ObjectModel


而SADL框架计算出来的这两个值为false的布尔变量,最后就会将sap:creatable和sap:updatable设置为false.


揭开SAP Fiori编程模型规范里注解的神秘面纱 - @ObjectModel


@ObjectModel.readOnly属性的前后台工作原理的神秘面纱,至此就揭开了,然而它只是SAP Fiori编程模型众多注解的冰山一角。敬请关注Jerry后续的分享,感谢阅读。


揭开SAP Fiori编程模型规范里注解的神秘面纱 - @ObjectModel


更多阅读


Jerry的通过CDS view + Smart Template 开发Fiori应用的blog合集


SAP Fiori应用的三种部署方式


Jerry的Fiori原创文章合集


SAP成都C4C小李探花:浅谈Fiori Design Guidelines


SAP Fiori + Vue = ?


Fiori Fundamentals和SAP UI5 Web Components


30分钟用Restful ABAP Programming模型开发一个支持增删改查的Fiori应用


SAP Fiori应用索引大全


介绍一种Fiori标准应用的增强方式



上一篇:asp.net 不用控件 循环输出数据库数据的方法


下一篇:SAP Fiori里的Adapt UI按钮,神出鬼没的奥秘