OSGi 應用程式
OSGi 應用程式會將一組軟體組集合成一個群組,以提供一致的商業邏輯。應用程式可以由不同的軟體組類型組成,例如啟用 Web 的軟體組,以及啟用持續性的軟體組。
一個 OSGi 應用程式中的軟體組會與定義在另一個 OSGi 應用程式中的軟體組、服務或套件隔離,除非這兩個應用程式明確共用那些軟體組、服務或套件。OSGi 應用程式可以直接包含 OSGi 軟體組,或是參照 OSGi 軟體組儲存庫中所管理的軟體組。
應用程式中的 OSGi 軟體組可與其他 OSGi 應用程式共用服務。如果 OSGi 應用程式產生任何外部服務和參照,則會在應用程式資訊清單中將其宣告,使其明確公開。同樣地,OSGi 應用程式所耗用的任何外部服務和參照,也會在應用程式資訊清單中宣告。OSGi 應用程式也可以使用 meta 資料,使其部分組成軟體組可在系統中共用。透過這種方式共用,可減少系統的記憶體和資源需求。
保存內容
- 如果沒有定義 Application-Content 標頭,則保存內容會定義 OSGi 應用程式內容。
- 如果有定義 Application-Content 標頭,則保存內容會定義可供應軟體組的起始軟體組儲存庫。 如果將具有特定版本的軟體組安裝在受控管的儲存庫中,而且該軟體組也包含在應用程式保存檔中,則會使用保存檔中的軟體組。
應用程式資訊清單
應用程式資訊清單 META-INF/APPLICATION.MF 說明應用程式層次的模組性。依預設,當沒有宣告應用程式資訊清單時,應用程式內容是包含在 OSGi 應用程式中的一組 OSGi 軟體組,並且不會產生或耗用外部服務或參照。
- Application-SymbolicName
OSGi 應用程式的唯一符號名稱,使用類似 Java 的套件表示法。
- Application-Version
應用程式的版本,使用軟體組版本的 OSGi 語法。
- Application-Name
應用程式的名稱.
- Application-ImportService
宣告軟體組的外部相依關係,以供「OSGi 架構」用於軟體組解析。可以宣告之每個服務的特定版本或版本範圍。
應用程式所耗用的一組外部服務過濾器。應用程式資訊清單必須包含服務所需的類別。如果未指定此標頭,則不會匯入任何所需的服務。
在以逗點區隔的清單中指定所需要的服務,服務介面名稱為首,後面接著屬性或指引。
例如:<service identifier>;<directives>;<attributes>
Application-ImportService 標頭具有下列屬性:test.it;filter="some_filter"- filter
- 一個 OSGi 服務過濾器。
- Application-ExportService
宣告在軟體組外部可看到的服務。未在這裡宣告的任何服務,只能在軟體組內看到。
應用程式所產生的一組外部服務過濾器。如果未指定此標頭,則不會匯出任何所需的服務。
在以逗點區隔的清單中指定所匯出的服務,請以服務介面名稱為首,後面接著屬性或指引。
例如:<service identifier>;<directives>;<attributes>
Application-ExportService 標頭具有下列屬性:test.it;filter="some_filter"- filter
- 一個 OSGi 服務過濾器。
- Use-Bundle
共用軟體組,其提供至少一個套件給應用程式軟體組。
用來滿足 Application-Content 清單中軟體組之套件相依關係的軟體組或複合軟體組清單。Use-Bundle 清單中的每一個軟體組或複合軟體組,必須向 Application-Content 清單中的至少一個軟體組,提供至少一個套件。在執行時期,會供應這些軟體組給共用軟體組空間。
您通常不需要 Use-Bundle 標頭,但在某些狀況下,此標頭會很有用。您可以利用它來限制可能進行共用的層次。舉例來說,您可以確保在匯入套件時,應用程式使用的軟體組,就是測試該應用程式時所使用的相同軟體組。或者,您可以確保在匯入套件時,兩個應用程式使用的軟體組相同。藉由在應用程式層次設定限制,軟體組就可以維持彈性。
- Application-WebModules
包含在應用程式中的非 OSGi 動態 Web 專案清單。
此標頭不屬於 OSGi 標準。
- Application-Content
- 此清單中包含複合軟體組、軟體組片段,以及應用程式中,在可接受之 OSGi 版本規格範圍內的軟體組。提示: 將軟體組片段併入 Application-Content 清單時,請務必併入該片段的主機軟體組。格式是以逗點區隔的模組宣告清單,其中,每一項模組宣告都使用下列格式:
<module identifier>;<directives>;<attributes>一般而言,模組 ID 是軟體組的符號名稱。如果所要參照的資源不是軟體組,則模組 ID 是相對於 OSGi 應用程式根目錄的路徑。
Application-Content 標頭具有下列屬性:- version
- 模組的版本是使用 OSGi 版本範圍語法來指定。請指定應用程式的版本下限,後面接著應用程式可以升級的版本上限。例如,"[1.0.0,2.0.0)" 代表 1.0.0 版及直到 2.0.0 版的所有更新版本,但 2.0.0 版除外。
Application-Content 標頭會定義組成商業服務的重要應用程式,但不會定義應用程式中的軟體組完整清單。如果列示在內容中的軟體組使用未包含在應用程式中的套件,則會執行相依關係分析,並將任何遺漏的軟體組併入。這些軟體組無法提供應用程式外部的服務,且不能套用安全保護功能。使用此機制來併入的軟體組是共用的。
部署資訊清單
安裝 OSGi 應用程式之後,應用程式資訊清單會指定構成應用程式的軟體組。它可以針對某些軟體組指定多個版本。
部署資訊清單 META-INF/DEPLOYMENT.MF 會指定構成應用程式的所有軟體組,包括遵循相依關係分析所需的軟體組。部署資訊清單會指定應用程式中所使用之每一個軟體組的實際版本。安裝「企業軟體組保存檔 (EBA)」資產時,會自動建立部署資訊清單,它會確保每次應用程式伺服器啟動時,構成應用程式的軟體組都相同。
EBA 會定義一組 OSGi 軟體組,這些 OSGi 軟體組會部署成單一 OSGi 應用程式,並與其他 OSGi 應用程式隔離。 EBA 檔案是單一保存檔,副檔名是 .eba。其中包含一組應用程式模組及/或應用程式資訊清單。
安裝應用程式之後,可藉由配置 EBA 資產來更新軟體組的版本。
- Application-SymbolicName
- 應用程式的唯一符號名稱,使用類似 Java 的套件表示法。這與應用程式資訊清單中的 Application-SymbolicName 值相符。
- Application-Version
- 應用程式的版本,使用軟體組版本的 OSGi 語法。這與應用程式資訊清單中的 Application-Version 值相符。
- Deployed-Content
軟體組符號名稱以及所要使用之確切版本的清單(以逗點區隔)。
此清單包括列示在應用程式資訊清單之 Application-Content 標頭中的所有軟體組,以及由相依關係分析匯入的軟體組。非 OSGi 模組類型可以用已轉換之軟體組的符號名稱來併入。
Deployed-Content 標頭具有下列指引:- deployed-version
- 軟體組的確切版本,使用 OSGi 版本語法來指定。