OSGi 片段
OSGi 片段是 Java™ 保存檔,其含有特定的資訊清單標頭,可讓它連接至指定的主機軟體組以運作。片段會被視為主機軟體組的一部分。在資訊沒有衝突的前提下,片段的相關定義會先與主機軟體組合併,然後再解析主機。 如果可能的話,會解析片段相依關係。如果無法解析片段相依關係,片段就不會連接至主機軟體組。片段不能有自己的類別載入器或軟體組啟動器。它不能置換主機軟體組中已存在的資訊。片段會以資源、類別和經允許標頭來延伸軟體組,可讓您自訂自己的軟體組。
OSGi 片段資訊清單檔
OSGi 片段 JAR 檔包含片段資訊清單檔。此檔案包含 meta 資料,可讓「OSGi 架構」將片段連接至主機軟體組。
下列程式碼是軟體組資訊清單檔 META-INF/MANIFEST.MF 的內容範例:
Manifest-Version: 1.0
Bundle-ManifestVersion: 2
Bundle-Name: Fragment
Bundle-SymbolicName: Fragment
Bundle-Version: 1.0.0.qualifier
Bundle-RequiredExecutionEnvironment: JavaSE-1.6
Fragment-Host: WebBundle;bundle-version=1.0.0.qualifier
Import-Package: org.apache.commons.logging;version="1.0.4"
Export-Package: com.sample.myservice.api;version="1.0.0"
這個資訊清單檔中的 meta 資料包括下列索引鍵內容:
- Fragment-Host
- 將片段鏈結至其潛在的軟體組主機。
- Bundle-Version
- 說明片段的版本,可讓軟體組的多個版本同時在相同的架構實例中作用。
- Bundle-Name
- 提供人類可讀的名稱給片段。
- Bundle-SymbolicName
- 用來識別架構中之片段的唯一名稱。它不能取代對 Bundle-Name 標頭的需求。
- Import-Package
- 宣告片段的外部相依關係,以供「OSGi 架構」用於片段解析。可以宣告每一個套件的特定版本或版本範圍。在這個資訊清單檔範例中,需要 org.apache.commons.logging 套件 1.0.4 版或更新版本。
- 此內容可用來指定您想要讓片段從執行時期匯入之任何套件的名稱。如果您沒有在此內容中指定軟體組所需的套件,當軟體組載入時,可能會出現 NoClassDefFound 異常狀況和編譯錯誤。註: 您也必須在包含該套件之軟體組的 Export-Package 內容中指定這個套件。限制: 對於不在工作區或目標平台的軟體組,如果軟體組資訊清單檔使用 Import-Package 內容來宣告軟體組相依關係,編輯器會將此相依關係標示為錯誤。 為了暫行解決這項限制,請確定您宣告為相依關係的所有軟體組都在工作區,或使用快速修正程式將軟體組新增至目標平台。如果要使用快速修正程式,請切換至「標記」視圖,然後用滑鼠右鍵按一下錯誤標記,並選取快速修正程式。重要: 當您在 MANIFEST.MF 檔中指定軟體組相依關係時,請使用內容 Import-Package 而非 Require-bundle。如果您使用 Require-bundle 來指定軟體組相依關係,則不會部署您的應用程式。Import-Package 可以更靈活的方式宣告相依關係:
- 您可以在需要的功能上宣告相依關係,而不是在此功能起源的軟體組,如此,對於軟體組不需要但包括在相依軟體組中的套件,就不會新增不必要的相依關係。
- 您可以為宣告的套件指定版本或版本範圍,因而不需要隨著軟體組不同版本的變更而作出反應。
- Export-Package
- 宣告在片段外部可看到的套件。未在這裡宣告的任何套件,只能在片段內看到。
- 此內容可用來指定您想要讓片段匯出至執行時期之任何套件的名稱。如果您沒有在此內容中指定其他軟體組所需的套件,相依的軟體組可能無法解析。