第 3 課:建立藍圖配置檔
藍圖配置檔包含軟體組的元件組合及配置資訊。這個檔案說明如何在 OSGi 服務登錄中登錄元件,或元件如何從 OSGi 服務登錄查閱服務。這項資訊會在執行時期使用,以便於啟動軟體組時建立必要元件的實例並加以配置。在本指導教學中,藍圖檔案定義了一項服務,以供其他元件用來存取第 2 課所定義的計數器。
關於這項作業
在本課程中,您將建立藍圖配置檔,以便定義和說明 CounterServiceBundle 所提供的服務。
如果要建立藍圖配置檔,請執行下列動作:
程序
結果
<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 檔。