SAP UI5 應用 index.html 裡 data-sap-ui-resourceroots 指令的含義和作用
如下圖所示:
<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.CombineLatest": "./" }'> </script>
我剛學習 SAP UI5 時,對 data-sap-ui-resourceroots 的作用很是費解。
瀏覽我們開發的整個 SAP UI5 專案資源,無論是 Component.js:
還是檢視的控制器:
還是檢視的 id 本身,都包含了 sap.ui.demo.CombineLatest 的字首:
如果我們把 index.html 裡的 data-sap-ui-resourceroots 指令去掉:
會發現應用根本無法載入了,Chrome 開發者工具裡報了很多資原始檔無法載入的錯誤。
摘取其中一條錯誤訊息出來分析。現在 Component.js 的載入路徑為:
https://sapui5.hana.ondemand.com/resources/sap/ui/demo/CombineLatest/Component.js
顯然,這個路徑是繼承自 index.html 裡 id 為 sap-ui-bootstrap 裡的 src 屬性定義的 SAP UI5 庫檔案:
我們工程檔案裡的 Component.js, 其 id 為 sap.ui.demo.CombineLatest.Component:
SAP UI5 框架在載入時,將 id 轉換成 url:
sap/ui/demo/CombineLatest/Component.js,
然後在其頭部,拼接上來自 id 為 sap-ui-bootstrap 裡的 src 屬性定義的 SAP UI5 庫檔案的字首:
https://sapui5.hana.ondemand.com/resources/
最後得到的路徑:
https://sapui5.hana.ondemand.com/resources/sap/ui/demo/CombineLatest/Component.js
顯然,這個路徑是錯誤的。因為 Component.js 僅僅存在於我們工程自身。
因此需要使用 data-sap-ui-resourceroots 告訴 SAP UI5 載入器,如果遇到字首為 sap.ui.demo.CombineLatest 的本地資原始檔,不要使用 sap-ui-core.js 的字首即 https://sapui5.hana.ondemand.com/resources,而是使用本地路徑./
修改之後,資源載入成功,正確的路徑應該是:http://localhost:3002/combine/Component.js
這個路徑是怎麼來的呢?
(1) Component.js 的 id 為 sap.ui.demo.CombineLatest.Component,因為 data-sap-ui-resourceroots 生效,將 sap.ui.demo.CombineLatest.Component 替換成 ./Component
(2) ./Component 替換成 URL:/Component.js
(3) ./之前的 url 為 localhost:3002/combine
得到最後的絕對路徑去載入 Component.js:
http://localhost:3002/combine/Component.js
更多Jerry的原創文章,盡在:"汪子熙":