OSGi 軟體組
OSGi 軟體組是一個 Java™ 保存檔,其中含有 Java 程式碼、資源,以及一個用來說明軟體組與其相依關係的資訊清單。此軟體組是應用程式的部署單元。
軟體組類型
- 應用程式軟體組
- 應用程式軟體組是您專為應用程式建立的軟體組。其為特定實例專用或隔離的,也就是說,不作為共用。會在應用程式資訊清單的 Application-Content 標頭中參照它們。
- 共用軟體組
- 共用軟體組不是應用程式專用的。共用軟體組中套件的單一實例可以供眾多應用程式使用。共用軟體組無法匯入應用程式軟體組中的套件或服務。應用程式中的共用軟體組必須透過參照提供,而不能直接包含在應用程式中。
- 共用軟體組會進一步細分成使用軟體組和供應軟體組:
- 使用軟體組
- 「使用軟體組」是一個共用軟體組,會提供至少一個套件給應用程式軟體組。使用軟體組是在應用程式資訊清單中的 Use-Bundle 標頭中參照。
- 供應軟體組
- 供應軟體組是共用軟體組,其提供至少一個套件或服務給應用程式軟體組、使用軟體組或另一個供應軟體組。應用程式資訊清單中不會參照供應軟體組,您的應用程式並不知道如何滿足每一個供應軟體組的需求。
OSGi 軟體組可以儲存在下列任何位置:
- 應用程式的企業軟體組保存檔 (EBA)。
- 伺服器內部 OSGi 軟體組儲存庫。
- 外部 OSGi 軟體組儲存庫。
應用程式軟體組可以儲存在 EBA 檔案或儲存庫中。共用軟體組儲存在儲存庫中(否則無法共用)。
從儲存庫取得軟體組的程序稱為供應。基於供應目的,用於軟體組的專有名詞如下:
- 被參照軟體組
- 被參照軟體組是應用程式資訊清單中所參照的軟體組,儲存在儲存庫中。
- 相依關係軟體組
- 相依關係軟體組是應用程式資訊清單中未參照的軟體組,但是應用程式資訊清單中所參照的軟體組或其他相依關係軟體組會使用它。
沒有直接包含在 EBA 檔案中的應用程式軟體組,是特定實例專用的被參照軟體組。使用軟體組是共用的被參照軟體組。供應軟體組是共用的相依關係軟體組。
OSGi 軟體組資訊清單檔
OSGi 軟體組 JAR 檔包含 JAR 資訊清單檔。此檔案包含 meta 資料,可讓「OSGi 架構」處理軟體組的模組層面。
下列程式碼是軟體組資訊清單檔 META-INF/MANIFEST.MF 的內容範例:
Manifest-Version: 1.0
Bundle-ManifestVersion: 2
Bundle-Name: MyService bundle
Bundle-SymbolicName: com.sample.myservice
Bundle-Version: 1.0.0
Bundle-Activator: com.sample.myservice.Activator
Import-Package: org.apache.commons.logging;version="1.0.4"
Export-EJB: ExampleBean
Export-Package: com.sample.myservice.api;version="1.0.0"
這個資訊清單檔中的 meta 資料包括下列索引鍵內容:
- Bundle-Version
- 說明軟體組的版本,可讓軟體組的多個版本同時在相同的架構實例中作用。
- Bundle-Name
- 提供人類可讀的名稱給軟體組。
- Bundle-SymbolicName
- 用來識別架構中之軟體組的唯一名稱。它不能取代對 Bundle-Name 標頭的需求。
- Bundle-Activator
- 從架構接收有關軟體組生命週期變更的通知。此內容可指定實作 org.osgi.framework.BundleActivator 介面的類別。
- Import-Package
- 宣告軟體組的外部相依關係,以供「OSGi 架構」用於軟體組解析。可以宣告每一個套件的特定版本或版本範圍。在這個資訊清單檔範例中,需要 org.apache.commons.logging 套件 1.0.4 版或更新版本。
- 此內容可用來指定您想要讓軟體組從執行時期匯入之任何套件的名稱。如果您沒有在此內容中指定軟體組所需的套件,當軟體組載入時,可能會出現編譯錯誤。註: 您也必須在包含該套件之軟體組的 Export-Package 內容中指定這個套件。限制: 對於不在工作區或目標平台的軟體組,如果軟體組資訊清單檔使用 Import-Package 內容來宣告軟體組相依關係,編輯器會將此相依關係標示為錯誤。 為了暫行解決這項限制,請確定您宣告為相依關係的所有軟體組都在工作區,或使用快速修正程式將軟體組新增至目標平台。如果要使用快速修正程式,請切換至「標記」視圖,然後用滑鼠右鍵按一下錯誤標記,並選取快速修正程式。重要: 當您在 MANIFEST.MF 檔中指定軟體組相依關係時,請使用內容 Import-Package 而非 Require-bundle。如果您使用 Require-bundle 來指定軟體組相依關係,則不會部署您的應用程式。Import-Package 可以更靈活的方式宣告相依關係:
- 您可以在需要的功能上宣告相依關係,而不是在此功能起源的軟體組,如此,對於軟體組不需要但包括在相依軟體組中的套件,就不會新增不必要的相依關係。
- 您可以為宣告的套件指定版本或版本範圍,因而不需要隨著軟體組不同版本的變更而作出反應。
- Export-EJB:
- 如果 EJB 專案已轉換成 OSGi 軟體組,且 Export-EJB 區段已新增至資訊清單,請使用此區段來列出您想要顯現的 EJB。若要將 EJB 新增至此區段,您可以手動編輯,或是用滑鼠右鍵按一下已轉換的 EJB 專案,並選取 。
- Export-Package
- 宣告在軟體組外部可看到的套件。未在這裡宣告的任何套件,只能在軟體組內看到。
- 此內容可用來指定您想要讓軟體組匯出至執行時期之任何套件的名稱。如果您沒有在此內容中指定其他軟體組所需的套件,相依的軟體組可能無法解析。
軟體組生命週期
架構可管理軟體組的生命週期。在您安裝及執行軟體組的過程中,它會經歷各種狀態。
軟體組的可能狀態如下:
- INSTALLED
- 已安裝軟體組,但未符合軟體組的所有相依關係。軟體組需要的套件尚未由目前任何已安裝的軟體組匯出。
- RESOLVED
- 已安裝軟體組,並符合軟體組的相依關係,但軟體組不在執行中。如果軟體組已啟動,並符合軟體組的所有相依關係,軟體組會跳過此狀態。
- STARTING
- 軟體組在啟動的過程中,所經歷的暫時狀態。
- ACTIVE
- 軟體組正在執行中。
- STOPPING
- 軟體組在停止的過程中,所經歷的暫時狀態。
- UNINSTALLED
- 軟體組不再存在於架構中。