sap.ui.core.Configuration 的作用简析

时间:2021-08-20 00:40:58

这个类的帮助文档链接如下,继承自:sap.ui.base.Object

sap.ui.core.Configuration 的作用简析

这个类用于收集并存储 SAP UI5 应用当前环境的配置。

Configuration 在创建 sap.ui.core.Core 时初始化一次。 有不同的方式来设置环境配置,罗列如下,按优先级升序排列

  • 系统定义的默认值
  • 服务器范围的默认值,从 /sap-ui-config.json 读取
  • 全局配置对象 window["sap-ui-config"] 的属性
  • bootstrap 标记的 data-sap-ui-config 属性中的配置字符串。
  • bootstrap 标签的各个 data-sap-ui-xyz 属性
  • 使用 url parameter
  • 此 Configuration 对象中的 Setter(仅针对某些参数)

也就是说,DOM 引用的属性覆盖系统默认值,URL 参数覆盖 DOM 属性(其中空 URL 参数将参数设置回其系统默认值)。 在运行时调用 setter 将覆盖在对象创建期间计算的任何先前设置。

参数的命名约定是:

  • 在 URL 中:sap-ui-PARAMETER-NAME="value"
  • 在 DOM 中:data-sap-ui-PARAMETER-NAME="value"
  • 其中 PARAMETER-NAME 是小写的参数名称。
  • 布尔参数的值不区分大小写,其中 truex 被解释为 true.

一些例子如下:

sap.ui.core.Configuration 的作用简析

  • data-sap-ui-async: 此配置设置使模块加载器能够异步加载模块和库预加载文件。

  • bindingsyntax:此配置参数定义是使用简单绑定语法还是使用复杂绑定语法。 该参数仅影响定义为字符串的绑定,例如在控件的构造函数中,或者在声明性视图(如 XML 视图)中指定绑定时。

  • frameOptions:用于防止点击劫持等安全漏洞。 使用 frameOptions 配置,开发人员可以定义是否允许 SAPUI5 在框架中嵌入运行,或者仅从受信任的来源运行,或者根本不允许。

Configuration 有个方法 applySettings:一次对配置应用多项更改。

如果更改的设置包含本地化相关设置,如语言或日历类型,则只会触发一个 localizationChanged 事件。 由于框架必须通知所有现有组件、元素、模型等本地化更改,使用 applySettings 可以显着减少多次更改的开销,尤其是当它们在已经创建 UI 之后发生时。

mSettings 可以包含此类的 API 中存在设置器方法 setXYZ 的任何属性 xyz。 同样,格式设置 API 的值可以在名称为 formatSettings 的嵌套对象中提供。