EquinoxOSGi系列之二搭建EquinoxOSGi核心环境.docx
- 文档编号:30297183
- 上传时间:2023-08-13
- 格式:DOCX
- 页数:11
- 大小:387.27KB
EquinoxOSGi系列之二搭建EquinoxOSGi核心环境.docx
《EquinoxOSGi系列之二搭建EquinoxOSGi核心环境.docx》由会员分享,可在线阅读,更多相关《EquinoxOSGi系列之二搭建EquinoxOSGi核心环境.docx(11页珍藏版)》请在冰豆网上搜索。
EquinoxOSGi系列之二搭建EquinoxOSGi核心环境
Equinox_OSGi系列之二搭建Equinox_OSGi核心环境
1、概述
在上文中讲到,Equinox包括核心框架,标准服务实现,面向J2EE的应用,新的部署更新框架及一些其他的研究方向。
本文主要针对Equinox实现的OSGi核心框架及EquinoxOSGi运行环境的搭建过程进行详细讲述。
用户在阅读下文时,应具有基本的Java编程及打包的概念并对OSGi标准的构成有一定的了解,理解OSGi框架及Bundle的概念。
2、OSGi核心框架
从OSGi核心框架示意图可以看到,OSGi核心框架主要包括模块层,生命周期层,服务层及安全层组成。
完整的OSGi核心框架实现,还包括包管理服务(PackageAdmin)、启动层次服务(StartLevel)、条件许可管理(ConditionalPermissionAdmin)、权限管理(PermissionAdmin)及URL处理服务(URLHandlers)等框架服务。
关于OSGi核心框架的详细介绍请参考OSGi标准规范。
3、Equinox的OSGiFramework实现
Equinox的OSGi框架实现包含在org.eclipse.osgi插件项目中。
在发布的Eclipse环境中,用户可以在Eclipse安装目录下的plugins目录中找到该插件。
该插件一般以"org.eclipse.osgi_<版本号>.jar"的JAR文件形式打包。
由于是从Eclipse3.0以前版本迁移到OSGi核心的缘故,目前的EquinoxOSGi实现中包含的代码非常繁杂。
在org.eclipse.osgi项目源代码中用户可以看到除了OSGi接口及框架实现外,还包括adaptor接口及默认的adaptor(defaultAdaptor),eclipseadaptor(eclipseAdaptor)实现,控制台实现(console),附加服务扩展(supplement),Bundle组件解析(resolver)和BundleJAR文件校验等功能。
在实际使用中,用户使用该Jar文件即可将OSGi框架运行起来(参考下文OSGi运行环境的搭建)。
作为一个产品级的应用,往往存在很多系统级的参数可供用户进行配置以调整系统的运行行为而满足不同环境的要求。
同样,Equinox运行环境也提供了大量的运行参数以供用户选择配置。
配置Equinox运行环境参数的方式主要有两种,一种是使用JVM环境变量;另一种方式是使用Equinox的配置文件(config.ini)。
用户在获取到org.eclipse.osgi_<版本号>.jar文件后,可以尝试以命令行的方式启动该Jar文件。
该Jar文件的入库主类是:
org.eclipse.core.runtime.adaptor.EclipseStarter。
java-jarorg.eclipse.osgi_3.3.1.R33x_v20070828.jar
用户会发现该程序执行后立即退出,控制台上没有任何输出。
这是因为不存在拥有可持续运行的代码功能,框架启动后即退出主线程。
下文中,我们会给出OSGi运行环境搭建的详细过程。
4、搭建EquinoxOSGi运行环境
4.1原始的OSGi环境
从Eclipse官方网站下载EquinoxOSGi框架。
将其下载到c:
\equinox目录中。
本文中使用的Equinox版本为3.3.1。
直接从命令行运行该jar文件时程序执行后会立即退出,为了更好的了解EquinoxOSGi框架的特点,我们在运行时添加JVM参数"osgi.console"。
如下图所示:
执行"java-Dosgi.console-jarorg.eclipse.osgi_3.3.1_R33x_v20070828.jar"后,系统给出"osgi>"命令输入提示。
输入"ss"命令后回车,用户可以看到上图所示"Frameworkislaunched."的信息。
同时,下方显式了系统启动的Bundle列表,id列为该Bundle在OSGi运行环境中的唯一运行标识,State列为该Bundle当前的状态,Bundle列显示了该Bundle组件的SymbolicName。
此时,OSGi框架已经处于运行状态。
EquinoxOSGiConsole提供了很多命令用于与OSGi框架交互,用户可以输入任何非OSGiConsole的内部命令字符,控制太将显示EquinoxConsole提供的所有命令。
如下下图所示:
执行"services"命令,用户可以看到当前OSGi框架中发布的所有的服务信息。
4.2以运行参数方式向OSGi环境中部署Bundle
下载EquinoxSDK,将plugins目录下的org.eclipse.osgi.services_3.1.200.v20070605.jar文件拷贝到C:
\equinox目录下。
修改命令行运行参数如下:
java-Dosgi.console-Dosgi.bundles=org.eclipse.osgi.services_3.1.200.v20070605.jar -jarorg.eclipse.osgi_3.3.1_R33x_v20070828.jar
执行该命令,系统运行结果如下图所示:
从运行结果可以看出,JVM参数"-Dosgi.bundles=org.eclipse.osgi.services_3.1.200.v20070605.jar"将org.eclipse.osgi.services组件部署到了OSGi运行环境中。
此时,该组件的状态为"RESOLVED",即该组件被框架解析但没有启动。
如果用户希望组件在加载的同时启动该组件,可以修改上述参数为:
-Dosgi.bundles=org.eclipse.osgi.services_3.1.200.v20070605.jar@2:
start。
"@2"指明该组件的启动级别,":
"后的"start"标明该组件在加载后启动。
按修改后的参数重新执行命令输出结果如下图所示:
从上图可以看出,部署的org.eclipse.osgi.services组件在加载后被OSGi框架启动,其状态显示为"ACTIVE"。
4.3以配置文件方式向OSGi环境中部署Bundle
从上述部署Bundle的方式看出,当部署多个Bundle时,使用JVM参数配置方式是不可取的。
EquinoxOSGi支持从配置文件中读取加载的Bundle,下面我们演示如何使用配置文件部署多个Bundle。
将EquinoxSDK中plugins目录下的org.eclipse.osgi.util_3.1.200.v20070605.jar文件拷贝到C:
\equinox目录下。
EquinoxOSGi提供了环境变量"osgi.configuration.area",该变量指明了配置文件config.ini的存储路径。
下面我们在C:
\equinox目录下添加config.ini文件,并在该文件中添加如下内容:
osgi.bundles=org.eclipse.osgi.services_3.1.200.v20070605.jar@2:
start,org.eclipse.osgi.util_3.1.200.v20070605.jar
修改OSGi框架启动命令行为:
java-Dosgi.console-Dosgi.configuration.area=. -jarorg.eclipse.osgi_3.3.1_R33x_v20070828.jar
执行上述命令后的输出结果如下图所示:
5、使用EclipseLauncher启动EquinoxOSGi
熟悉EclipseIDE环境的用户会注意到3.2版本(包括3.2)以前Eclipse安装目录下存在eclipse.exe和startup.jar两个文件,用于启动Eclipse运行环境。
从3.3版本开始,Equinox将startup.jar拆分为两个不同的Bundle(Fragment)放置在了plugins目录下。
用户可以从Equinox站点下载Launcher。
下载后的3.3.1发布版本的Launcher包括下面两个组件:
org.eclipse.equinox.launcher_1.0.1.R33x_v20070828.jar
org.eclipse.equinox.launcher.win32.win32.x86_1.0.1.R33x_v20070828 [目录]
在进行下述操作之前,我们需要调整C:
\equinox的目录结构,在该目录下添加"configuration"和"plugins"两个目录,将所有的Bundle组件(包括目录)转移到plugins目录下;将config.ini文件转移到configuration目录下,将Launcher包中的"eclipse.exe"文件拷贝到C:
\equinox目录下。
此时的目录结构如下图所示:
plugins目录下的内容如下图所示:
修改命令行OSGi框架启动命令为:
eclipse.exe-console-noexit
执行该命令后,在弹出的控制台中输入"ss"命令,输出结果如下:
5.1使用eclipse.ini文件
除了从命令行传入eclipse.exe使用的运行参数外,用户也可以配置与eclipse.exe的文件同名的ini文件存放eclipse.exe运行所需要的参数。
用户应将该ini文件放置在eclipse.exe所在的文件目录下。
我们在C:
\equinox目录下添加eclipse.ini文件,在该文件中添加如下内容:
-console
-noexit
直接点击eclipse.exe程序图标启动EquinoxOSGi运行环境。
程序运行结果如下图所示:
至此,EquinoxOSGi完整的运行环境已经搭建完成。
如果用户希望将新的Bundle发布到该环境中,只需要修改configuration目录下config.ini文件,将新的bundle添加到osgi.bundles参数下。
6、常见问题
用户在上述操作步骤中,会发现在configuration目录下生成一些错误日志文件,如果用户发现日志中出现以下内容:
java.lang.IllegalStateException:
Unabletoacquireapplicationservice.Ensurethattheorg.eclipse.core.runtimebundleisresolvedandstarted(seeconfig.ini).
atorg.eclipse.core.runtime.internal.adaptor.EclipseAppLauncher.start(EclipseAppLauncher.java:
72)
atorg.eclipse.core.runtime.adaptor.EclipseStarter.run(EclipseStarter.java:
363)
atorg.eclipse.core.runtime.adaptor.EclipseStarter.run(EclipseStarter.java:
176)
atsun.reflect.NativeMethodAccessorImpl.invoke0(NativeMethod)
atsun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:
39)
atsun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:
25)
atjava.lang.reflect.Method.invoke(Method.java:
585)
atorg.eclipse.equinox.launcher.Main.invokeFramework(Main.java:
508)
atorg.eclipse.equinox.launcher.Main.basicRun(Main.java:
447)
atorg.eclipse.equinox.launcher.Main.run(Main.java:
1173)
用户可以在config.ini文件中添加如下配置:
eclipse.ignoreApp=true
7、小结
在上文中,我们详细介绍了EquinoxOSGi环境组成及其搭建过程。
在下一篇文档中,我们会对EquinoxOSGi的运行参数做详细的介绍,同时提供一种方式使得OSGi框架能够自动发现部署的OSGibundle而不用频繁修改配置文件。
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- EquinoxOSGi 系列 搭建 核心 环境