建立藍圖 XML 檔

藍圖配置檔包含軟體組的元件組合及配置資訊。這個檔案說明如何在 OSGi 服務登錄中登錄元件,或元件如何從 OSGi 服務登錄查閱服務。這項資訊會在執行時期使用,以便於啟動軟體組時建立必要元件的實例並加以配置。

程序

  1. 用滑鼠右鍵按一下軟體組專案,並選取新建 > 藍圖檔案。即會開啟「新建藍圖檔案」精靈。
  2. 在檔名欄位中,輸入您藍圖配置檔的名稱,然後按下一步。
  3. 在精靈的「新增或移除其他的藍圖名稱空間」頁面中,選取您想新增至藍圖檔案的名稱空間。
    您可以為藍圖延伸、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 方法。

    其他相關資訊:藍圖安全和 OSGi 應用程式

    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 的交易需求。

    註: 如果您想新增未列在此清單中的其他名稱空間,請切換至「程式碼」視圖,並輸入名稱空間。
  4. 按一下完成。藍圖配置檔會在編輯器中開啟。
  5. 按一下新增,將元件組合和配置資訊新增至藍圖配置檔。
    Bean
    bean 元素定義要實例化的藍圖元件。請按一下確定,將引數和內容新增至 Bean。
    進一步瞭解 Bean 屬性:
    ID
    id 屬性用來識別元件。如果會從藍圖中的其他位置來參照該元件(例如,從服務定義來參照該元件),則必須指定這個屬性。
    類別
    class 屬性指定要將元件的哪個實作類別實例化。
    啟動
    這個選用屬性定義管理程式的啟動模式。支援下列兩種啟動模式:
    立即
    在起始設定「藍圖儲存器」期間啟動管理程式。
    延遲
    視需要啟動管理程式。
    依預設,會將啟動設為「立即」。
    範圍
    視範圍設定而定,Bean 管理程式可以建立單一或多個物件實例。「藍圖儲存器」規格定義了兩個主要範圍:
    單態
    Bean 管理程式會建立單一 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 藍圖儲存器規格說明主題。

  6. 按一下開啟 WebSphere 藍圖連結描述子,來建立 OSGi 藍圖配置檔,且其中含有軟體組鑑別別名連結的資源參照。

    如果將 OSGi 應用程式部署成資產,當該 OSGi 應用程式含有 OSGi 藍圖連結配置檔時,連結配置檔會提供預設鑑別別名值,以便在連結資源參照時使用。

    如需藍圖連結檔的相關資訊,請參閱建立藍圖連結 XML 檔。

  7. 按一下新增和移除其他的藍圖名稱空間,將名稱空間新增至藍圖 XML 檔。
    1. 在「藍圖名稱空間」對話框中,選取您想新增至藍圖檔案的名稱空間。
    2. 按一下完成。

    會根據您新增至藍圖 XML 檔的藍圖名稱空間,來啟用這些元素。

    環境定義
    bpjpa:context 元素會延伸藍圖交易內所用之 JPA Bean 的 Apache Aries 藍圖規格。在您新增 JPA 名稱空間時,會新增此元素。請按一下新增,將屬性新增至元素。
    內容位置保留元
    bpext:property-placeholder 元素可在 Apache Aries 藍圖規格中新增延伸。當您新增「藍圖延伸」名稱空間時,會新增此元素。請按一下新增,將屬性新增至元素。
    資源參照
    bpresref:resource-reference 元素會將資源參照(例如:資料來源) 注入至 Bean 或服務。當您新增「資源參照」名稱空間時,會新增此元素。請按一下新增,將屬性新增至元素。
    交易
    tx:transaction 元素會藉由在藍圖檔案中新增交易內容,來延伸 Apache Aries 藍圖規格。當您新增「交易」名稱空間時,會新增此元素。請按一下新增,將屬性新增至元素。
  8. 儲存檔案。

    如需 OSGi 藍圖 XML 檔的相關資訊,請參閱下列子主題:

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

File name: tcrtblueprintxml.html