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
宣告在片段外部可看到的套件。未在這裡宣告的任何套件,只能在片段內看到。
此內容可用來指定您想要讓片段匯出至執行時期之任何套件的名稱。如果您沒有在此內容中指定其他軟體組所需的套件,相依的軟體組可能無法解析。
Icon that indicates the type of topic Concept topic
Timestamp icon Last updated: last_date

File name: cbundlefragment.html