OGSI初體驗-創建Helloworld項目

在OSGi中，軟件是以Bundle的形式發布的。一個Bundle由Java類和其它資源構成，它可為其它的Bundle提供服務，也可以導入其它Bundle中的Java包；同時，OSGi的Bundle也可以為其所在的設備提供一些功能。Eclipse為開發OSGiBundle提供了優秀的支持，它不僅提供了向導來創建OSGi Bundle，而且還提供了內嵌的Equinox容器，您可以使用該容器執行和調試OSGi插件。請注意每一個Eclipse插件，從本質上說，都是一個OSGi Bundle，只是這個OSGiBundle多加了一些Eclipse專用的代碼而已。下面我們來看看如何使用Eclipse開發一個簡單的OSGi的HelloWorld Bundle。

新建Bundle

1) 在Eclipse中，點擊“File->New->Project”菜單，您將會看到新項目創建對話框；

2) 在新項目對話框中，選擇“Plug-inProject(插件項目)”並點擊“Next(下一步)”按鈕，您將看到插件項目對話框；

3) 在插件項目對話框中，請鍵入下列值：

Project Name(項目名稱)：com.javaworld.sample.HelloWorld

Target Platform(目標平台)：an OSGiFramework->Standard （OSGi框架->標准）

4) 對其它的要求輸入值采用缺省值，並點擊“Next(下一步)”按鈕，您將會看到插件上下文對話框；

5) 在插件上下文對話框中，請選擇缺省值並點擊“Next(下一步)”按鈕；

6) 在模板對話框中，請選擇“Hello OSGiBundle（你好，OSGi包）”模板，然后點擊“Finish(完成)”按鈕完成該項目。

Eclipse將花幾秒鍾生成HelloWorld Bundle模板代碼，它將新建兩個文件：Activator.java和MANIFEST.MF，下面，讓我們看看這兩個文件：

src： Activator.java

package com.shane.demo;

import org.osgi.framework.BundleActivator;
import org.osgi.framework.BundleContext;

public class Activator implements BundleActivator {

	/*
	 * (non-Javadoc)
	 * @see org.osgi.framework.BundleActivator#start(org.osgi.framework.BundleContext)
	 */
	public void start(BundleContext context) throws Exception {
		System.out.println("Hello World!!");
	}
	
	/*
	 * (non-Javadoc)
	 * @see org.osgi.framework.BundleActivator#stop(org.osgi.framework.BundleContext)
	 */
	public void stop(BundleContext context) throws Exception {
		System.out.println("Goodbye World!!");
	}

}

如果您想讓您開發的Bundle能在其啟動或關閉時通知自身，那么您應新建一個類，讓它實現BundleActivator接口，同時，您還需要遵行下列規則：

這個實現了BundleActivator接口的類必須有一個public的、不帶參數的構造函數，這樣，OSGi框架就能調用該類的Class.newInstance()方法創建這個BundleActivator對象；

容器將調用Activator類的start()方法來啟動Bundle，因此，我們可以在start()方法中執行一些資源初始化的操作，例如，我們可以在該方法中獲取數據庫連接，以備后用。這個start()方法的唯一參數是一個BundleObject對象，Bundles可以通過該對象和OSGi框架通訊，我們可以從該對象中獲取OSGi容器相關的一些信息；如果某個Bundle拋出異常，容器將之置為“stopped(已停止)”狀態，此時，這個Bundle就不能對外提供服務。

如果我們要關閉一個Bundle，容器將調用Activator類中的stop()方法。因此，我們可在stop()方法中執行一些資源清理任務，比如釋放數據庫連接。

一旦Activator類准備就緒，您就可以通過MANIFEST.MF文件把該包的合法名稱傳給容器。下面，我們就看看這個MANIFEST.MF文件

　　

MANIFEST.MF文件

該文件是Bundle的部署描述文件，其格式和正常JAR文件包中的MANIFEST.MF文件相同，因此它由一系列的屬性及這些屬性對應的值組成，屬性名位於每一行的開頭，我們可以稱其為屬性頭。OSGi規范規定，您可以使用屬性頭向容器描述您的Bundle。您的HelloWorld Bundle的MANIFEST.MF文件看起來應該如清單2所示：

src：MANIFEST.MF

Manifest-Version: 1.0
Bundle-ManifestVersion: 2
Bundle-Name: Demo
Bundle-SymbolicName: com.shane.Demo
Bundle-Version: 1.0.0.qualifier
Bundle-Activator: com.shane.demo.Activator
Bundle-Vendor: SHANE
Bundle-RequiredExecutionEnvironment: JavaSE-1.8
Import-Package: org.osgi.framework;version="1.3.0"

　　

我們來看看這個文件中使用的屬性頭：

Bundle-ManifestVersion

該屬性頭告訴OSGi容器，本Bundle將遵循OSGi規范，數值2表示本Bundle和OSGi規范第4版本兼容；如果該屬性的數值為1，那么則表示本包和OSGi版本3或更早版本兼容。

Bundle-Name

該屬性頭為本Bundle定義了一個簡短的、可以閱讀的名稱；

Bundle-SymbolicName

這個屬性頭為本Bundle定義了一個唯一的、非本地化的名字；當您需要從別的Bundles中訪問某一指定的Bundle時，您就要使用這個名字。

Bundle-Version

該屬性頭給出了本Bundle的版本號。

Bundle-Activator

該屬性頭給出了本Bundle中使用的監聽器類名字，這個屬性值是可選的。監聽器將對Activator中的start()和stop()方法監聽。在程序清單2中，該屬性頭的值為com.javaworld.sample.helloworld.Activator。

Bundle-Vendor

該屬性頭是對本Bundle發行商的表述。

Bundle-Localization

該屬性頭包含了本Bundle的本地化文件所在的位置，我們的HelloWorld Bundle中並沒有本地化文件，但Eclipse IDE仍自動產生這個屬性頭

Import-Package

該屬性頭定義了本Bundle中引入的Java包，我將在本文后面的依賴性管理小節中詳細講解這個問題。現在，HelloWorld Bundle已經准備就緒，讓我們來運行並看看它的輸出結果。

 運行Bundle

我在前面提到，Eclipse IDE中有一個內嵌的EquinoxOSGi容器，您可以利用它來執行或調試OSGi Bundle。請按照下面步驟執行剛才的HelloWorld Bundle:

1）點擊Run -> Run Configuretions... 將 Name改成HelloWorld Bundle。確保workspace 中的com.shane.Demo 選中。

現在，請單擊Run(運行)按鈕，您應該看到控制台視圖上打印出“HelloWorld”。其實，Eclipse是在控制台視圖中打開OSGi控制台。

OSGi控制台是OSGi容器的命令行界面，您可以在這個控制台上啟動、停止、安裝、更新和刪除Bundles。在EclipseIDE中，請點擊該控制台視圖獲得焦點，然后按回車鍵，這時您可以看到OSGi提示符，如圖2所示：(譯者注，在Eclipse3.3中，如果您沒有看到OSGi提示符，請在圖1的運行配置中，點擊Arguments標簽，然后在ProgramArguments(程序參數)輸入框中鍵入“-console”，然后再次運行該Bundle)。