OSGi Bundle之Hello World
本文是《你好,OSGi》系列的第二部分。之前曾介紹過OSGi是什么,下面將繼續(xù)上篇介紹的內(nèi)容,講述一個簡單的OSGi Bundle:Hello World是如何開發(fā)的。
51CTO編輯推薦:OSGi入門與實踐全攻略
開發(fā)一個簡單的Hello World的OSGi Bundle(OSGi綁定包)
在OSGi中,軟件是以Bundle的形式發(fā)布的。一個Bundle由Java類和其它資源構(gòu)成,它可為其它的Bundle提供服務,也可以導入其它Bundle中的Java包;同時,OSGi的Bundle也可以為其所在的設備提供一些功能。Eclipse為開發(fā)OSGiBundle提供了優(yōu)秀的支持,它不僅提供了向?qū)韯?chuàng)建OSGi Bundle,而且還提供了內(nèi)嵌的Equinox容器,您可以使用該容器執(zhí)行和調(diào)試OSGi插件。請注意每一個Eclipse插件,從本質(zhì)上說,都是一個OSGi Bundle,只是這個OSGiBundle多加了一些Eclipse專用的代碼而已。下面我們來看看如何使用Eclipse開發(fā)一個簡單的OSGi的HelloWorld Bundle。
3.1.新建Bundle
1) 在Eclipse中,點擊“File->New->Project”菜單,您將會看到新項目創(chuàng)建對話框;
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,下面,讓我們看看這兩個文件:
3.1.1. Activator.java文件
源代碼清單1.Activator.java
- package com.javaworld.sample.helloworld;
- importorg.osgi.framework.BundleActivator;
- importorg.osgi.framework.BundleContext;
- publicclass Activator implements BundleActivator {
- public void start(BundleContext context)throws Exception {
- System.out.println("Helloworld");
- }
- public void stop(BundleContext context)throws Exception {
- System.out.println("GoodbyeWorld");
- }
- }
如果您想讓您開發(fā)的Bundle能在其啟動或關閉時通知自身,那么您應新建一個類,讓它實現(xiàn)BundleActivator接口,同時,您還需要遵行下列規(guī)則:
這個實現(xiàn)了BundleActivator接口的類必須有一個public的、不帶參數(shù)的構(gòu)造函數(shù),這樣,OSGi框架就能調(diào)用該類的Class.newInstance()方法創(chuàng)建這個BundleActivator對象;
容器將調(diào)用Activator類的start()方法來啟動Bundle,因此,我們可以在start()方法中執(zhí)行一些資源初始化的操作,例如,我們可以在該方法中獲取數(shù)據(jù)庫連接,以備后用。這個start()方法的唯一參數(shù)是一個BundleObject對象,Bundles可以通過該對象和OSGi框架通訊,我們可以從該對象中獲取OSGi容器相關的一些信息;如果某個Bundle拋出異常,容器將之置為“stopped(已停止)”狀態(tài),此時,這個Bundle就不能對外提供服務。
如果我們要關閉一個Bundle,容器將調(diào)用Activator類中的stop()方法。因此,我們可在stop()方法中執(zhí)行一些資源清理任務,比如釋放數(shù)據(jù)庫連接。
一旦Activator類準備就緒,您就可以通過MANIFEST.MF文件把該包的合法名稱傳給容器。下面,我們就看看這個MANIFEST.MF文件。
3.1.2. MANIFEST.MF文件
該文件是Bundle的部署描述文件,其格式和正常JAR文件包中的MANIFEST.MF文件相同,因此它由一系列的屬性及這些屬性對應的值組成,屬性名位于每一行的開頭,我們可以稱其為屬性頭。OSGi規(guī)范規(guī)定,您可以使用屬性頭向容器描述您的Bundle。您的HelloWorld Bundle的MANIFEST.MF文件看起來應該如清單2所示:
源代碼清單2. Hello World Bundle中的MANIFEST.MF文件
- Manifest-Version:1.0
- Bundle-ManifestVersion:2
- Bundle-Name:HelloWorld Plug-in
- Bundle-SymbolicName:com.javaworld.sample.HelloWorld
- Bundle-Version:1.0.0
- Bundle-Activator:com.javaworld.sample.helloworld.Activator
- Bundle-Vendor:JAVAWORLD
- Bundle-Localization:plugin
- Import-Package:org.osgi.framework;version="1.3.0"
我們來看看這個文件中使用的屬性頭:
Bundle-ManifestVersion
該屬性頭告訴OSGi容器,本Bundle將遵循OSGi規(guī)范,數(shù)值2表示本Bundle和OSGi規(guī)范第4版本兼容;如果該屬性的數(shù)值為1,那么則表示本包和OSGi版本3或更早版本兼容。
Bundle-Name
該屬性頭為本Bundle定義了一個簡短的、可以閱讀的名稱;
Bundle-SymbolicName
這個屬性頭為本Bundle定義了一個唯一的、非本地化的名字;當您需要從別的Bundles中訪問某一指定的Bundle時,您就要使用這個名字。
Bundle-Version
該屬性頭給出了本Bundle的版本號。
Bundle-Activator
該屬性頭給出了本Bundle中使用的監(jiān)聽器類名字,這個屬性值是可選的。監(jiān)聽器將對Activator中的start()和stop()方法監(jiān)聽。在程序清單2中,該屬性頭的值為com.javaworld.sample.helloworld.Activator。
Bundle-Vendor
該屬性頭是對本Bundle發(fā)行商的表述。
Bundle-Localization
該屬性頭包含了本Bundle的本地化文件所在的位置,我們的HelloWorld Bundle中并沒有本地化文件,但Eclipse IDE仍自動產(chǎn)生這個屬性頭
Import-Package
該屬性頭定義了本Bundle中引入的Java包,我將在本文后面的依賴性管理小節(jié)中詳細講解這個問題?,F(xiàn)在,HelloWorld Bundle已經(jīng)準備就緒,讓我們來運行并看看它的輸出結(jié)果。
3.2. 運行Bundle
我在前面提到,Eclipse IDE中有一個內(nèi)嵌的EquinoxOSGi容器,您可以利用它來執(zhí)行或調(diào)試OSGi Bundle。請按照下面步驟執(zhí)行剛才的HelloWorld Bundle:
1 ) 單擊RunàRun… 菜單(譯者注,在Eclipse3.3中,請單擊RunàOpen Run Diglog…菜單);
2) Eclipse會打開“Create,manage and run configuration(新建、管理和運行配置)”對話框,請雙擊”EquinoxOSGi Framework”按鈕,Eclipse將打開運行時配置對話框;
3) 在上面的對話框中,將Name(名稱)輸入框的值改為HelloWorld Bundle;
4) 您會注意到在Workspace插件目錄下,有一個名為com.javaworld.sample.HelloWorld的插件,請選中它;在TargetPlatform(目標平臺)下,請確保org.eclipse.osgi插件被選中。您的Run(運行)對話框應該看起來如圖1所示:
圖1. HelloWorld Bundle的運行配置
5) 現(xiàn)在,請單擊Run(運行)按鈕,您應該看到控制臺視圖上打印出“HelloWorld”。其實,Eclipse是在控制臺視圖中打開OSGi控制臺。
3.2.1. OSGi控制臺
OSGi控制臺是OSGi容器的命令行界面,您可以在這個控制臺上啟動、停止、安裝、更新和刪除Bundles。在EclipseIDE中,請點擊該控制臺視圖獲得焦點,然后按回車鍵,這時您可以看到OSGi提示符,如圖2所示:(譯者注,在Eclipse3.3中,如果您沒有看到OSGi提示符,請在圖1的運行配置中,點擊Arguments標簽,然后在ProgramArguments(程序參數(shù))輸入框中鍵入“-console”,然后再次運行該Bundle)。
圖2. OSGi控制臺和HelloWorldActivator.java
下面是幾個經(jīng)常使用的OSGi命令,您可以使用這些命令與OSGi容器進行交互。
- ss: 該命令顯示所有已安裝的Bundles及它們的狀態(tài),它將顯示Bundle ID,Bundle的簡短名稱及Bundle狀態(tài);
- start< bundleid>: 該命令將啟動一個Bundle;
- stop< bundleid>: 該命令將停止一個Bundle;
- update< bundleid>: 該命令使用新的JAR文件更新一個Bundle;
- install< bundleid>: 該命令將一個新的Bundle安裝到OSGi容器;
- uninstall< bundleid>: 從OSGi容器中卸載一個已安裝的Bundle。
請注意,這些命令是OSGi規(guī)范中規(guī)定的,因此,您可以使用它們和任何OSGi容器交互。
讀到這里,希望您對OSGi Bundle的開發(fā)有了一個大致的了解。
【編輯推薦】