部署資訊清單檔
部署資訊清單 META-INF/DEPLOYMENT.MF 會指定構成應用程式的所有軟體組,包括遵循相依關係分析所需的軟體組。部署資訊清單會指定應用程式中所使用之每一個軟體組的實際版本。安裝 EBA 資產時,會自動建立部署資訊清單,它會確保每次應用程式伺服器啟動時,構成應用程式的軟體組都相同。
安裝應用程式之後,可藉由配置 EBA 資產來更新軟體組的版本。
下列程式碼是部署資訊清單檔的內容範例:
Manifest-Version: 1.0
Deployed-Content: bundle1;deployed-version=1.0.0.qualifier
Application-SymbolicName: bundle.app
Application-Version: 1.0.0.qualifier
Import-Package: javax.servlet.jsp;version="2.0.0",javax.persistence;ve
rsion="0.0.0",javax.servlet.http;version="2.5.0",javax.servlet;versio
n="2.5.0",javax.servlet.jsp.el;version="2.0.0",javax.servlet.jsp.tage
xt;version="2.0.0",javax.el;version="2.0.0"
部署資訊清單包含下列標頭:
- Manifest-Version
- 資訊清單格式的版本號碼。
- Application-SymbolicName
- 應用程式的唯一符號名稱,使用類似 Java™ 的套件表示法。這個符號名稱與應用程式資訊清單中的 Application-SymbolicName 值相符。
- Application-Version
- 應用程式的版本,使用軟體組版本的 OSGi 語法。這個版本與應用程式資訊清單中的 Application-Version 值相符。
- Deployed-Content
軟體組符號名稱以及所要使用之確切版本的清單(以逗點區隔)。
此清單包括列示在應用程式資訊清單之 Application-Content 標頭中的所有軟體組,以及由相依關係分析匯入的軟體組。非 OSGi 模組類型可以用已轉換之軟體組的符號名稱來併入。
Deployed-Content 標頭具有下列指引:- deployed-version
- 軟體組的確切版本,使用 OSGi 版本語法來指定。
- Deployed-Use-Bundle
- 可滿足 Application-Content 清單中軟體組之套件相依關係的軟體組或複合軟體組清單。Deployed-Use-Content 清單中的每一個元素,必須提供至少一個套件給 Deployed-Content 清單中的至少一個軟體組。Deployed-Use-Bundle 清單實際是 Use-Bundle 清單的子集。這些軟體組會在執行時期載入共用軟體組空間中。應用程式部署之後,管理者可以更新從 Use-Bundle 清單對映至 Deployed-Use-Bundle 清單的軟體組。
- Provision-Bundle
- 解析 OSGi 應用程式之後所需的其他軟體組和複合軟體組清單。每個軟體組或複合軟體組都會在執行時期載入共用軟體組空間中;不過,可能並不需要它們。應用程式部署之後,管理者即無法更新 Provision-Bundle 清單中的軟體組。
- Import-Package
- Deployed-Content 清單中的軟體組從 Deployed-Use-Bundle 和 Provision-Bundle 清單中的軟體組和複合軟體組耗用的套件清單。針對從 Deployed-Use-Bundle 清單耗用的套件,套件匯入具有 ;bundle-symbolic-name 和 ;bundle-version 屬性。