< 上一個課程 | 下一個課程 >

第 3 課:建立藍圖配置檔

藍圖配置檔包含軟體組的元件組合及配置資訊。這個檔案說明如何在 OSGi 服務登錄中登錄元件,或元件如何從 OSGi 服務登錄查閱服務。這項資訊會在執行時期使用,以便於啟動軟體組時建立必要元件的實例並加以配置。在本指導教學中,藍圖檔案定義了一項服務,以供其他元件用來存取第 2 課所定義的計數器。

關於這項作業

在本課程中,您將建立藍圖配置檔,以便定義和說明 CounterServiceBundle 所提供的服務。

如果要建立藍圖配置檔,請執行下列動作:

程序

  1. 用滑鼠右鍵按一下 CounterServiceBundle 專案,並選取新建 > 藍圖檔案,然後按一下完成。藍圖配置檔會在編輯器中開啟。
  2. 新增元件組合和配置資訊至藍圖配置檔:
    1. 在編輯器的「設計」標籤中,按一下新增。即會開啟「新增項目」對話框。
    2. 按一下 Bean,然後按一下確定。即會開啟「Bean 詳細資料」對話框。
    3. 配置 Bean:
      1. 在 Bean ID 欄位中,輸入 CounterBean。
      2. 在 Bean 類別欄位中,按一下瀏覽。即會開啟「選取類型」對話框。在選擇類型名稱欄位中,輸入 CounterImpl,然後選取 CounterImpl 類別。按一下確定。
      3. 按一下確定,接受所做的變更,並關閉對話框。
      4. 在編輯器中,於起始設定方法欄位的「方法參照」區段下,輸入 init。
      會將 Bean 新增至藍圖檔案。
    4. 按一下藍圖,然後按一下新增。即會開啟「新增項目」對話框。
    5. 按一下服務,然後按一下確定。即會開啟「服務詳細資料」對話框。
    6. 配置服務:
      1. 在服務介面欄位中,按一下瀏覽,然後選取您在第 2 課 中建立的 Counter 介面。按一下確定。
      2. 在 Bean 參照欄位中,按一下瀏覽,然後選取 Bean:CounterBean。按一下確定。
      3. 按一下確定,接受所做的變更,並關閉對話框。
      會將服務新增至藍圖檔案。
  3. 儲存檔案。

結果

切換至「原始檔」標籤,以檢視藍圖配置原始檔:
<blueprint xmlns="http://www.osgi.org/xmlns/blueprint/v1.0.0">
	<bean id="CounterBean" class="com.ibm.ws.eba.counter.CounterImpl" init-method="init"/>
	<service id="CounterBeanService" ref="CounterBean"
		interface="com.ibm.ws.eba.counter.Counter" />
</blueprint>
提示: 如果要將原始檔格式化,請按 Ctrl + Shift + F。

下一步

進一步瞭解藍圖配置檔:
bean
bean 元素定義要實例化的藍圖元件。
在本指導教學中,bean 元素會呼叫 CounterImpl 類別建構子,因而將 Counter 元件實例化。建立類別之後,會呼叫起始設定方法 getCount()。
class
class 屬性指定要將元件的哪個實作類別實例化。
id
id 屬性用來識別元件。如果會從藍圖中的其他位置來參照該元件(例如,從服務定義來參照該元件),則必須指定這個屬性。
init-method
在建立元件時,會呼叫 init-method init()。如果您不想在軟體組起始設定期間呼叫方法,請移除這個屬性。
service
service 元素定義將元件匯出至 OSGi 服務登錄。
在本指導教學中,service 元素會將名稱是 Counter 的元件匯出到 OSGi 服務登錄,成為一項服務,且該 OSGi 服務登錄使用的是 interface 屬性所指定的 com.ibm.ws.eba.counter.Counter 介面。
ref
ref 屬性會參照所匯出元件的元件 ID。此 ID 定義在元件元素中。
interface
interface 屬性會參照元件類別所實作的介面。

如需藍圖配置檔的相關資訊,請參閱 OSGi 藍圖 XML 和 OSGi 藍圖元件模型 (RFC124)。

課程回顧

您已為「OSGi 計數器」軟體組建立藍圖配置檔。

在本課程中,您已瞭解下列主題:
  • 如何建立 blueprint.xml 檔。
  • 如何配置 blueprint.xml 檔。
< 上一個課程 | 下一個課程 >
Icon that indicates the type of topic Tutorial lesson topic
Timestamp icon Last updated: last_date

File name: counter_lesson3.html