應用程式資訊清單檔

應用程式資訊清單檔包含 meta 資料,可讓「OSGi 架構」處理軟體組的模組層面。

下列程式碼是應用程式資訊清單檔的內容範例:
Manifest-Version: 1.0
Application-Name: OSGi Blog Application
Application-SymbolicName: com.ibm.ws.eba.example.blog.app
Application-Version: 1.0.0
Application-Content: com.ibm.ws.eba.example.blog.api;version=1.0.0,
 com.ibm.ws.eba.example.blog.persistence;version=1.0.0,
 com.ibm.ws.eba.example.blog.web;version=1.0.0,
 com.ibm.ws.eba.example.blog;version=1.0.0,
 com.ibm.json.java;version="1.0.0"
Application-ManifestVersion: 1.0
Application-ImportService: com.ibm.ws.eba.counter.Greet
Application-ExportService: com.ibm.ws.eba.example.blog.api.BloggingService
應用程式資訊清單可以包含下列標頭:
Application-SymbolicName

OSGi 應用程式的唯一符號名稱,使用類似 Java™ 的套件表示法。

Application-Version

應用程式的版本,使用軟體組版本的 OSGi 語法。

Application-Name

應用程式的名稱.

Application-ImportService

宣告軟體組的外部相依關係,以供「OSGi 架構」用於軟體組解析。可以宣告之每個服務的特定版本或版本範圍。

應用程式所耗用的一組外部服務過濾器。應用程式資訊清單必須包含服務所需的類別。如果未指定此標頭,則不會匯入任何所需的服務。

在以逗點區隔的清單中指定所需要的服務,服務介面名稱為首,後面接著屬性或指引。
<service identifier>;<directives>;<attributes>
例如:
test.it;filter="some_filter"
Application-ImportService 標頭具有下列屬性:
filter
一個 OSGi 服務過濾器。
Application-ExportService

宣告在軟體組外部可看到的服務。未在這裡宣告的任何服務,只能在軟體組內看到。

應用程式所產生的一組外部服務過濾器。如果未指定此標頭,則不會匯出任何所需的服務。

在以逗點區隔的清單中指定所匯出的服務,請以服務介面名稱為首,後面接著屬性或指引。
<service identifier>;<directives>;<attributes>
例如:
test.it;filter="some_filter"
Application-ExportService 標頭具有下列屬性:
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 標頭會定義組成商業服務的重要應用程式,但不會定義應用程式中的軟體組完整清單。如果列示在內容中的軟體組使用未包含在應用程式中的套件,則會執行相依關係分析,並將任何遺漏的軟體組併入。這些軟體組無法提供應用程式外部的服務,且不能套用安全保護功能。使用此機制來併入的軟體組是共用的。

Icon that indicates the type of topic Concept topic
Timestamp icon Last updated: last_date

File name: capplicationmf.html