建立藍圖 XML 檔
藍圖配置檔包含軟體組的元件組合及配置資訊。這個檔案說明如何在 OSGi 服務登錄中登錄元件,或元件如何從 OSGi 服務登錄查閱服務。這項資訊會在執行時期使用,以便於啟動軟體組時建立必要元件的實例並加以配置。
程序
- 用滑鼠右鍵按一下軟體組專案,並選取新建 > 藍圖檔案。即會開啟「新建藍圖檔案」精靈。
- 在檔名欄位中,輸入您藍圖配置檔的名稱,然後按下一步。
- 在精靈的「新增或移除其他的藍圖名稱空間」頁面中,選取您想新增至藍圖檔案的名稱空間。 您可以為藍圖延伸、JPA、資源參照和交易,新增名稱空間。進一步瞭解藍圖名稱空間:
表 1. 藍圖名稱空間的說明 綱目 URL 說明 藍圖延伸 http://aries.apache.org/blueprint/xmlns/blueprint-ext/v1.0.0 IBM® 藍圖延伸
「OSGi 藍圖」程式設計模型的延伸,例如:欄位注入。
藍圖安全 http://www.ibm.com/appserver/schemas/blueprint/security/v1.0.0 IBM 藍圖安全
配置 Bean 安全,以便只讓獲指派指定角色的使用者存取 Bean 方法。
JPA http://aries.apache.org/xmlns/jpa/v1.0.0 JPA 藍圖支援
提供「Java™ 持續性 API (JPA)」至藍圖的整合。持續性單元和持續性環境定義可以注入至藍圖管理 Bean。
資源參照 http://www.ibm.com/appserver/schemas/8.0/blueprint/resourcereference 藍圖資源參照支援
提供給 WebSphere® Application Server JNDI 中所宣告的物件,例如:要注入至藍圖管理 Bean 的資料來源和 Connection Factory。
交易 http://aries.apache.org/xmlns/transactions/v1.0.0 藍圖交易支援
容許開發人員宣告藍圖管理 Bean 的交易需求。
註: 如果您想新增未列在此清單中的其他名稱空間,請切換至「程式碼」視圖,並輸入名稱空間。 - 按一下完成。藍圖配置檔會在編輯器中開啟。
- 按一下新增,將元件組合和配置資訊新增至藍圖配置檔。
- Bean
- bean 元素定義要實例化的藍圖元件。請按一下確定,將引數和內容新增至 Bean。
- 進一步瞭解 Bean 屬性:
- ID
- id 屬性用來識別元件。如果會從藍圖中的其他位置來參照該元件(例如,從服務定義來參照該元件),則必須指定這個屬性。
- 類別
- class 屬性指定要將元件的哪個實作類別實例化。
- 啟動
- 這個選用屬性定義管理程式的啟動模式。支援下列兩種啟動模式:
- 立即
- 在起始設定「藍圖儲存器」期間啟動管理程式。
- 延遲
- 視需要啟動管理程式。
- 範圍
- 視範圍設定而定,Bean 管理程式可以建立單一或多個物件實例。「藍圖儲存器」規格定義了兩個主要範圍:
- 單態
- Bean 管理程式會建立單一 Bean 實例,每當要求該管理程式提供物件時,就會傳回該實例。
- 原型
- 每當要求 Bean 管理程式提供物件時,該管理程式就會建立新的 Bean 實例。
- 相依於
- 指定管理程式 ID 清單。列出的管理程式會在管理程式啟動之前先啟動。管理程式可以具有明確的或隱含的相依關係。dependsOn 屬性是定義明確的相依關係。對管理程式定義內之其他管理程式的參照則定義了隱含的相依關係。
- Factory 參照
- 指定擔任 Factory 之 Bean 或參照管理程式的 ID。指定的物件必須具有 Factory 方法(由 Factory 方法屬性指定)。
- 銷毀方法
- 指定當「藍圖儲存器」銷毀物件實例時,所要呼叫的方法。
- Factory 方法
- 指定靜態 Factory 方法的名稱。
- 起始設定方法
- 在建立元件時,會呼叫起始設定方法。如果您不想在軟體組起始設定期間呼叫方法,請移除這個屬性。
- 參照
- reference 元素指定在服務登錄中找到的服務。請按一下確定,將項目新增至參照中。
- 進一步瞭解「參照」屬性:
- ID
- id 屬性用來識別元件。如果會從藍圖中的其他位置來參照該元件(例如,從服務定義來參照該元件),則必須指定這個屬性。
- 介面
- interface 屬性會參照元件類別所實作的介面。
- 啟動
- 這個選用屬性定義管理程式的啟動模式。支援下列兩種啟動模式:
- 立即
- 在起始設定「藍圖儲存器」期間啟動管理程式。
- 延遲
- 視需要啟動管理程式。
- 可用性
- 根據服務參照管理程式來控制需求,此服務參照管理程式至少需有一項服務符合選取準則,藍圖儲存器起始設定作業才會繼續進行。可用性屬性有下列兩個值:
- 選用
- 不一定要有符合準則的服務。
- 必要
- 必須至少有一項服務符合準則。
- 過濾器
- 指定用來選取服務的過濾表示式。
- 逾時
- 指定 Proxy 等待支持的服務變成可用的時間量(毫秒)。
- 元件名稱
- 指定過濾器所搜尋的元件。
- 相依於
- 指定管理程式 ID 清單。列出的管理程式會在管理程式啟動之前先啟動。管理程式可以具有明確的或隱含的相依關係。dependsOn 屬性是定義明確的相依關係。對管理程式定義內之其他管理程式的參照則定義了隱含的相依關係。
- 參照清單
- reference-list 元素可讓 reference 元素尋找多個相符的服務。請按一下確定,將項目新增至參照清單中。
- 進一步瞭解「參照清單」屬性:
- ID
- id 屬性用來識別元件。如果會從藍圖中的其他位置來參照該元件(例如,從服務定義來參照該元件),則必須指定這個屬性。
- 介面
- interface 屬性會參照元件類別所實作的介面。
- 啟動
- 這個選用屬性定義管理程式的啟動模式。支援下列兩種啟動模式:
- 立即
- 在起始設定「藍圖儲存器」期間啟動管理程式。
- 延遲
- 視需要啟動管理程式。
- 可用性
- 根據服務參照管理程式來控制需求,此服務參照管理程式至少需有一項服務符合選取準則,藍圖儲存器起始設定作業才會繼續進行。可用性屬性有下列兩個值:
- 選用
- 不一定要有符合準則的服務。
- 必要
- 必須至少有一項服務符合準則。
- 過濾器
- 指定用來選取服務的過濾表示式。
- 成員類型
- 指定參照清單管理程式所提供的成員類型。「成員類型」屬性支援:
- 服務物件
- 注入服務 Proxy 物件清單。
- 服務參照
- 注入服務參照物件清單。
- 元件名稱
- 指定過濾器所搜尋的元件。
- 相依於
- 指定管理程式 ID 清單。列出的管理程式會在管理程式啟動之前先啟動。管理程式可以具有明確的或隱含的相依關係。dependsOn 屬性是定義明確的相依關係。對管理程式定義內之其他管理程式的參照則定義了隱含的相依關係。
- 服務
- service 元素定義將元件匯出至 OSGi 服務登錄。請按一下確定,將項目新增至服務中。
- 進一步瞭解「服務」屬性:
- ID
- id 屬性用來識別元件。如果會從藍圖中的其他位置來參照該元件(例如,從服務定義來參照該元件),則必須指定這個屬性。
- 介面
- interface 屬性會參照元件類別所實作的介面。
- 啟動
- 這個選用屬性定義管理程式的啟動模式。支援下列兩種啟動模式:
- 立即
- 在起始設定「藍圖儲存器」期間啟動管理程式。
- 延遲
- 視需要啟動管理程式。
- 自動匯出
- 自動匯出設定是由「自動匯出」屬性來指定,並支援下列四個選項:
- 停用
- 如果沒有指定「自動匯出」屬性,則此為預設值。必須使用介面屬性或介面子元素,來指定屬性清單。
- 介面
- 使用服務類別和其任何超類別所實作的所有公用介面,來登錄服務。
- 類別階層
- 使用服務類別和其任何公用超類別,來登錄服務。
- 所有類別
- 結合介面和類別階層選項。
- 等級
- 您可以使用等級屬性,以特定的等級來顯露服務。
- 參照
- ref 屬性會參照所匯出元件的元件 ID。此 ID 定義在元件元素中。
- 相依於
- 指定管理程式 ID 清單。列出的管理程式會在管理程式啟動之前先啟動。管理程式可以具有明確的或隱含的相依關係。dependsOn 屬性是定義明確的相依關係。對管理程式定義內之其他管理程式的參照則定義了隱含的相依關係。
- 類型轉換器
- type-converters 元素會在資料類型之間轉換值。請按一下確定,將項目新增至類型轉換器中。
如需藍圖配置檔的相關資訊,請參閱 OSGi 藍圖 XML 檔說明主題和 OSGi 藍圖儲存器規格說明主題。
- 按一下開啟 WebSphere 藍圖連結描述子,來建立 OSGi 藍圖配置檔,且其中含有軟體組鑑別別名連結的資源參照。
如果將 OSGi 應用程式部署成資產,當該 OSGi 應用程式含有 OSGi 藍圖連結配置檔時,連結配置檔會提供預設鑑別別名值,以便在連結資源參照時使用。
如需藍圖連結檔的相關資訊,請參閱建立藍圖連結 XML 檔。
- 按一下新增和移除其他的藍圖名稱空間,將名稱空間新增至藍圖 XML 檔。
- 在「藍圖名稱空間」對話框中,選取您想新增至藍圖檔案的名稱空間。
- 按一下完成。
會根據您新增至藍圖 XML 檔的藍圖名稱空間,來啟用這些元素。
- 環境定義
- bpjpa:context 元素會延伸藍圖交易內所用之 JPA Bean 的 Apache Aries 藍圖規格。在您新增 JPA 名稱空間時,會新增此元素。請按一下新增,將屬性新增至元素。
- 內容位置保留元
- bpext:property-placeholder 元素可在 Apache Aries 藍圖規格中新增延伸。當您新增「藍圖延伸」名稱空間時,會新增此元素。請按一下新增,將屬性新增至元素。
- 資源參照
- bpresref:resource-reference 元素會將資源參照(例如:資料來源) 注入至 Bean 或服務。當您新增「資源參照」名稱空間時,會新增此元素。請按一下新增,將屬性新增至元素。
- 交易
- tx:transaction 元素會藉由在藍圖檔案中新增交易內容,來延伸 Apache Aries 藍圖規格。當您新增「交易」名稱空間時,會新增此元素。請按一下新增,將屬性新增至元素。
- 儲存檔案。
如需 OSGi 藍圖 XML 檔的相關資訊,請參閱下列子主題:
- OSGi 藍圖 XML 檔
藍圖 XML 檔定義及說明應用程式的各種元件。 - 建立藍圖連結 XML 檔
藍圖連結 XML 檔 ibm-eba-bnd.xml 含有軟體組鑑別別名連結的資源參照。如果將 OSGi 應用程式部署成資產,當該 OSGi 應用程式含有 OSGi 藍圖連結配置檔時,連結配置檔會提供預設鑑別別名值,以便在連結資源參照時使用。
上層主題: 建立 OSGi 專案