SAP UI5 的初始化过程
加载 SAPUI5 运行时后开始初始化过程。
SAPUI5 运行时的初始化包括以下步骤:
(1) jQuery 插件主要位于 jQuery.sap 命名空间中,提供 SAPUI5 的基本功能,例如模块化概念、日志框架、性能测量等。
如下图所示:
(2) 定义了全局对象 sap:
(3) sap.ui.core.Core 类与其所有依赖项一起执行。
(4) 运行时配置(runtime configuration )由不同来源确定。
(5) 加载配置中声明的所有库和模块及其依赖项, 例如下面这段代码里的 lib:
<script id="sap-ui-bootstrap" src="https://sapui5.hana.ondemand.com/resources/sap-ui-core.js" data-sap-ui-theme="sap_bluecrystal" data-sap-ui-libs="sap.m, sap.ui.comp" data-sap-ui-bindingSyntax="complex" data-sap-ui-compatVersion="edge" data-sap-ui-preload="async" data-sap-ui-resourceroots='{ "sap.ui.demo.tabledelete": "./" }'></script>
(6) 对于每个加载的库,都会加载配置主题的 CSS 文件。
例如:https://sapui5.hana.ondemand.com/resources/sap/ui/core/themes/base/library.css
当所有库都加载完毕并且文档准备就绪时,内核的 initEvent 被触发并执行所有注册的处理程序。
Initialization Readiness
执行或启动应用程序的最佳时间点是在框架初始化之后。有三种方法可以让自己适应这个时间框架。以下列表详细描述了这些初始化准备挂钩,并提供了何时使用它们的示例。根据您的用例,您可能更喜欢一种方式而不是另一种方式。
ComponentSupport module
在框架初始化后执行代码的最复杂方法是使用 sap.ui.core.ComponentSupport.
此选项适用于您希望使用 sap.ui.core.UIComponent 作为应用程序入口点的场景。
ComponentSupport 允许您在 HTML 文件中声明性地定义一个或多个 sap.ui.core.UIComponent 实例,并负责为您创建必要的 sap.ui.core.ComponentContainer。
有关详细的使用指南,请参阅 ComponentSupport 文档。
Standalone data-sap-ui-oninit module
除了使用 sap.ui.core.ComponentSupport,您还可以在 SAPUI5 引导脚本元素上定义一个名为 data-sap-ui-oninit 的数据属性。
此属性应引用有效的 SAPUI5 模块,如下面的代码段所示。
<!DOCTYPE html><html><head> <meta charset="utf-8"> <title>SAPUI5 Walkthrough</title> <script id="sap-ui-bootstrap" src="https://sapui5.hana.ondemand.com/resources/sap-ui-core.js" data-sap-ui-async="true" data-sap-ui-resourceroots='{ "sap.ui5.walkthrough": "./" }' data-sap-ui-oninit="module:sap/ui5/walkthrough/index"> </script></head><body><div>Hello World</div></body></html>
SAPUI5 核心将确保在框架初始化过程后在正确的时间点加载和执行 data-sap-ui-oninit 模块。在此模块中,您可以执行其他应用程序代码,例如创建一个新的 XML 视图实例。
此外,由于不需要额外的内联 script 标记,因此专用的 oninit 模块可以根据您的要求实现更好的 CSP( Content Security Policy) 合规性。
这种方式在 Jerry 的文章SAP UI5 初学者教程之二:SAP UI5 的引导过程 Bootstrap 里有详细阐述。
attachInit function
attachInit 函数的回调在框架初始化后直接执行。这段代码可以写在你的主 HTML 文件中的一个单独的内联 script 标签中:
sap.ui.getCore().attachInit(function(){ // 应用程序自己的启动逻辑可以写在这里});
Loading of Additional Resources During Bootstrap
SAPUI5 运行时在引导期间为控制库加载和解释附加资源。 文件按以下顺序加载:
(1) Library bootstrap file //resources//library.js
library.js 是一个 JavaScript 文件,其中包含库提供的所有枚举类型的 JavaScript 代码以及独立于库中控件的特定于库的初始化代码。该文件调用 sap.ui.getCore().InitLibrary 方法,其中包含一个描述库内容的对象(包含的控件列表、元素等)。对于使用 SAPUI5 应用程序开发工具或 SAPUI5 离线构建工具开发的库,此文件在构建过程中自动生成。
(2) Library style sheet file //resources//themes//library.css
包含与此库相关的所有样式的标准 CSS 文件。对于应用程序开发工具,此文件在构建期间自动生成。
Dynamic Loading of Libraries
SAPUI5 提供了 sap.ui.getCore().loadLibary() 方法,除了运行时配置中声明的库外,还提供了运行时加载库。 加载后,您可以使用库中的所有控件。 对于这些额外的库,同样的限制适用于声明的库:只有在 HTML 页面的 document.ready 事件之后才能访问文档对象模型 (DOM)。 此外,渲染适用于这些库的方式与声明的库相同。