OSGi 複合軟體組
複合軟體組會將軟體組集結成聚集,以確保行為一致。複合軟體組含有一些軟體組,或位於工作區或目標平台外之軟體組的參照。複合軟體組可確保特定版本的一組共用軟體組行為一致。
重要: 適用於 WebSphere® Application Server 傳統版
複合軟體組保存檔 (CBA) 會將共用軟體組集結成聚集。CBA 可以包含 OSGi 軟體組,或是參照內部軟體組儲存庫中所管理的軟體組。若您想要確保一整組共用軟體組的行為一致,則建立 CBA。 您可以使用 CBA 將特定版本的那一組軟體組佈線至應用程式。
CBA 是保存檔,副檔名為 .cba。其中包含用來定義 CBA 的複合資訊清單 META-INF/COMPOSITEBUNDLE.MF,並選擇性地包含要植入儲存庫的一些 OSGi 軟體組。CBA 包含或參照的軟體組是以確切的版本來定義,相對地,EBA 的軟體組是以版本範圍來定義。
複合軟體組安裝在執行時期的內部軟體組儲存庫中。如果 CBA 直接包含 OSGi 軟體組,這些軟體組會安裝在儲存庫中,就像是個別上傳的一樣。CBA 也會新增至軟體組儲存庫中。如果 CBA 參照 OSGi 軟體組,這些軟體組必須存在於內部軟體組儲存庫中。
CBA 安裝在內部軟體組儲存庫中之後,當該應用程式解析後,想要使用軟體組的所有應用程式都可以使用其軟體組。如果軟體組和 CBA 兩者都可以提供必要的相同版本套件或服務,則供應程序會從 CBA 選取套件或服務。
CBA 與企業軟體組保存檔 (EBA) 之間具有下列差異:
- CBA 具有複合資訊清單,是模組性陳述式,主張可以部署軟體組,而不是解析軟體組。 EBA 檔案具有應用程式資訊清單,是供應陳述式。
- CBA 可以匯入或匯出套件,但 EBA 檔案不能。
- EBA 檔案不需要完整定義其內容。部署應用程式之後,會執行相依關係分析,並可以供應其他軟體組。
- EBA 檔案可以定義其內容中的軟體組是共用的。
- CBA 中的軟體組會顯示在儲存庫中,但 EBA 檔案中的軟體組是應用程式專用。
OSGi 複合軟體組資訊清單檔
此檔案中的 meta 資料包括下列索引鍵內容:
- Manifest-Version
- 說明資訊清單檔的版本。
- CompositeBundle-ManifestVersion
- 說明複合軟體組的版本。
- Bundle-Name
- 提供人類可讀的名稱給複合軟體組。
- 如果您沒有指定一值,預設值是複合軟體組符號名稱。
- Bundle-SymbolicName
- 用來識別架構中之複合軟體組的唯一名稱。它不能取代對 Bundle-Name 標頭的需求。
- Bundle-Version
- 說明複合軟體組的版本,可讓複合軟體組的多個版本同時在相同的架構實例中作用。
- CompositeBundle-Content
- 複合軟體組中的軟體組和軟體組片段清單。所有軟體組和軟體組片段都必須可供部署,並且必須包含在 cba 檔中,或存在於本端軟體組儲存庫中。軟體組和片段必須具有確切的版本號碼。如果您需要相同的複合軟體組,但其中含有不同版本的內容,則需要建立不同版本的複合軟體組,每一種用法各一個版本。
- 格式是以逗點區隔的模組宣告清單,其中,每一項模組宣告都使用下列格式:
<module identifier>;<directives>;<attributes> - CompositeBundle-Content 標頭具有下列屬性:
- version
- 模組的版本是使用 OSGi 版本範圍語法來指定。必須將版本指定為確切的範圍,例如 "[1.0.0,1.0.0]"。
- Import-Package
- 宣告軟體組的外部相依關係,以供「OSGi 架構」用於軟體組解析。可以宣告每一個套件的特定版本或版本範圍。
- 此內容可用來指定您想要讓軟體組從執行時期匯入之任何套件的名稱。如果您沒有在此內容中指定軟體組所需的套件,當軟體組載入時,可能會出現 NoClassDefFound 異常狀況。
- 註: 您也必須在包含套件之軟體組的 Export-Package 內容中,指定您想要匯入的套件(使用 Import-Package)。
- Export-Package
- 宣告在軟體組外部可看到的套件。未在這裡宣告的任何套件,只能在軟體組內看到。
- 此內容可用來指定您想要讓軟體組匯出至執行時期之任何套件的名稱。如果您沒有在此內容中指定其他軟體組所需的套件,相依的軟體組可能無法解析。
- CompositeBundle-ExportService
服務介面名稱和選用過濾器清單,用來識別存在於複合軟體組中的服務、且這些服務可以匯出,以便在複合軟體組之外使用。只要在複合軟體組外部可以看到匯出之服務所實作的介面,就可以在複合軟體組外部使用那些介面。
格式是以逗點區隔的服務清單,在形式上是一個服務介面名稱,後面是屬性或指引。 CompositeBundle-ExportService 標頭具有下列屬性:- filter
- 一個 OSGi 服務過濾器。
- CompositeBundle-ImportService
服務介面名稱和選用過濾器清單,用來識別複合軟體組內容想從複合軟體組外部使用的服務。在執行時期必須至少存在一項這類服務。
格式是以逗點區隔的服務清單,在形式上是一個服務介面名稱,後面是屬性或指引。 CompositeBundle-ImportService 標頭具有下列屬性:- filter
- 一個 OSGi 服務過濾器。