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

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

这个类用于收集并存储 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 是小写的参数名称。
• 布尔参数的值不区分大小写，其中 true 和 x 被解释为 true.

一些例子如下：

• data-sap-ui-async: 此配置设置使模块加载器能够异步加载模块和库预加载文件。
• bindingsyntax：此配置参数定义是使用简单绑定语法还是使用复杂绑定语法。 该参数仅影响定义为字符串的绑定，例如在控件的构造函数中，或者在声明性视图（如 XML 视图）中指定绑定时。
• frameOptions：用于防止点击劫持等安全漏洞。 使用 frameOptions 配置，开发人员可以定义是否允许 SAPUI5 在框架中嵌入运行，或者仅从受信任的来源运行，或者根本不允许。

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

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

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