Equinox 和 OSGI 介绍
来源:互联网 发布:软件爆破教程 编辑:程序博客网 时间:2024/05/16 19:00
1、概述
在上文中讲到,Equinox包括核心框架,标准服务实现,面向J2EE的应用,新的部署更新框架及一些其他的研究方向。本文主要针对Equinox实现的OSGi核心框架及Equinox OSGi运行环境的搭建过程进行详细讲述。
用户在阅读下文时,应具有基本的Java编程及打包的概念并对OSGi标准的构成有一定的了解,理解OSGi框架及Bundle的概念。
2、OSGi核心框架
从OSGi核心框架示意图可以看到,OSGi核心框架主要包括模块层,生命周期层,服务层及安全层组成。完整的OSGi核心框架实现,还包括包管理服务(Package Admin)、启动层次服务(Start Level)、条件许可管理(Conditional Permission Admin)、权限管理(Permission Admin)及URL处理服务(URL Handlers)等框架服务。
关于OSGi核心框架的详细介绍请参考OSGi标准规范。
3、Equinox的OSGi Framework实现
Equinox的OSGi框架实现包含在org.eclipse.osgi插件项目中。在发布的Eclipse环境中,用户可以在Eclipse安装目录下的plugins目录中找到该插件。该插件一般以"org.eclipse.osgi_<版本号>.jar"的JAR文件形式打包。由于是从Eclipse3.0以前版本迁移到OSGi核心的缘故,目前的Equinox OSGi 实现中包含的代码非常繁杂。
在org.eclipse.osgi项目源代码中用户可以看到除了OSGi接口及框架实现外,还包括adaptor接口及默认的adaptor(defaultAdaptor),eclipse adaptor(eclipseAdaptor)实现,控制台实现(console),附加服务扩展(supplement),Bundle组件解析(resolver)和Bundle JAR文件校验等功能。
在实际使用中,用户使用该Jar文件即可将OSGi框架运行起来(参考下文OSGi运行环境的搭建)。作为一个产品级的应用,往往存在很多系统级的参数可供用户进行配置以调整系统的运行行为而满足不同环境的要求。同样,Equinox运行环境也提供了大量的运行参数以供用户选择配置。配置Equinox运行环境参数的方式主要有两种,一种是使用JVM环境变量;另一种方式是使用Equinox的配置文件(config.ini)。
用户在获取到org.eclipse.osgi_<版本号>.jar文件后,可以尝试以命令行的方式启动该Jar文件。该Jar文件的入库主类是:org.eclipse.core.runtime.adaptor.EclipseStarter。
java -jar org.eclipse.osgi_3.3.1.R33x_v20070828.jar
用户会发现该程序执行后立即退出,控制台上没有任何输出。这是因为不存在拥有可持续运行的代码功能,框架启动后即退出主线程。下文中,我们会给出OSGi运行环境搭建的详细过程。
4、搭建Equinox OSGi运行环境
4.1 原始的OSGi环境
从Eclipse官方网站下载Equinox OSGi框架。将其下载到c:/equinox目录中。本文中使用的Equinox版本为3.3.1。直接从命令行运行该jar文件时程序执行后会立即退出,为了更好的了解Equinox OSGi框架的特点,我们在运行时添加JVM参数"osgi.console"。如下图所示:
执行"java -Dosgi.console -jar org.eclipse.osgi_3.3.1_R33x_v20070828.jar"后,系统给出"osgi>"命令输入提示。输入"ss"命令后回车,用户可以看到上图所示"Framework is launched."的信息。同时,下方显式了系统启动的Bundle列表,id列为该Bundle在OSGi运行环境中的唯一运行标识,State列为该Bundle当前的状态,Bundle列显示了该Bundle组件的SymbolicName。
此时,OSGi框架已经处于运行状态。
Equinox OSGi Console提供了很多命令用于与OSGi框架交互,用户可以输入任何非OSGi Console的内部命令字符,控制太将显示Equinox Console提供的所有命令。如下下图所示:
执行"services"命令,用户可以看到当前OSGi框架中发布的所有的服务信息。
4.2 以运行参数方式向OSGi环境中部署Bundle
下载Equinox SDK,将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 -jar org.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参数配置方式是不可取的。Equinox OSGi支持从配置文件中读取加载的Bundle,下面我们演示如何使用配置文件部署多个Bundle。
将Equinox SDK中plugins目录下的org.eclipse.osgi.util_3.1.200.v20070605.jar文件拷贝到C:/equinox目录下。
Equinox OSGi提供了环境变量"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=. -jar org.eclipse.osgi_3.3.1_R33x_v20070828.jar
执行上述命令后的输出结果如下图所示:
5、使用Eclipse Launcher启动Equinox OSGi
熟悉Eclipse IDE环境的用户会注意到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程序图标启动Equinox OSGi运行环境。程序运行结果如下图所示:
至此,Equinox OSGi完整的运行环境已经搭建完成。如果用户希望将新的Bundle发布到该环境中,只需要修改configuration目录下config.ini文件,将新的bundle添加到osgi.bundles参数下。
6、常见问题
用户在上述操作步骤中,会发现在configuration目录下生成一些错误日志文件,如果用户发现日志中出现以下内容:
java.lang.IllegalStateException: Unable to acquire application service. Ensure that the org.eclipse.core.runtime bundle is resolved and started (see config.ini).
at org.eclipse.core.runtime.internal.adaptor.EclipseAppLauncher.start(EclipseAppLauncher.java:72)
at org.eclipse.core.runtime.adaptor.EclipseStarter.run(EclipseStarter.java:363)
at org.eclipse.core.runtime.adaptor.EclipseStarter.run(EclipseStarter.java:176)
at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:39)
at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:25)
at java.lang.reflect.Method.invoke(Method.java:585)
at org.eclipse.equinox.launcher.Main.invokeFramework(Main.java:508)
at org.eclipse.equinox.launcher.Main.basicRun(Main.java:447)
at org.eclipse.equinox.launcher.Main.run(Main.java:1173)
用户可以在config.ini文件中添加如下配置:
eclipse.ignoreApp=true
7、小结
在上文中,我们详细介绍了Equinox OSGi环境组成及其搭建过程。在下一篇文档中,我们会对Equinox OSGi的运行参数做详细的介绍,同时提供一种方式使得OSGi框架能够自动发现部署的OSGi bundle而不用频繁修改配置文件
1、概述
上文我们对Equinox OSGi运行环境的组成及搭建过程做了详细讲述。本文主要对Equinox OSGi运行环境的可配置参数及其作用加以介绍,从而使用户在实际使用过程中可以对Equinox运行环境更好地进行控制。
Equinox项目沿袭Eclipse的特点,具有高度的可配置性。用户可以通过命令行参数或系统属性参数(JVM属性参数)两种方式对Equinox OSGi运行环境进行设定。命令行参数可以看作是系统属性参数的简化方式,Equinox中提供的很多系统属性参数可能不具有对应的命令行快捷设定。
2、Equinox配置参数详解
Equinox配置的参数在实际使用中可以通过以下三种方式:
- 在命令行中,使用Java虚拟机参数-D作为系统属性来设定,如:-Declipse.ignoreApp=true;
- 在配置文件config.ini文件中进行配置,如:osgi.framework=plugins/org.eclipse.osgi_<版本号>.jar
- 在Eclipse Launcher的配置文件.ini文件中进行配置。在此配置文件中用户需要使用命令行参数而不是系统属性的格式。如:-console。用户在发布Equinox或RCP应用时可以设定启动程序(Eclipse Launcher)的名称和图标,如将启动程序改为:MyApp.exe,则对应的启动配置文件应命名为:MyApp.ini。
下表列举了Equinox3.3版本主要的配置参数。该列表包括系统参数,用于JVM属性配置或config.ini文件配置;命令行参数(如果有)用于.ini文件配置;参数的简要说明描述该参数的用途。
说明:
- 表中所列参数来自于Eclipse3.3帮助文档,关于参数的解释可能不够准确,请用户参考Eclipse帮助获取详细信息。
- 表中所列参数严格说来仅部分用于Equinox OSGi,全部适用于Eclipse。在下述说明中将不区分Equinox和Eclipse。
该属性用于设定系统运行时Java虚拟机启动的时间(单位为毫秒)
eclipse.ee.install.verify如果该属性值设定为true,在Bundle组件安装时,OSGi框架会检查框架运行所需要的运行环境。该参数默认值为false。eclipse.exitOnError该参数设定为true时,如果系统在运行时遇到无法处理的错误,则系统会退出。该参数默认值为true。eclipse.ignoreApp该参数设定为true时,系统主线程将不启动默认的application,同时停止并退出系统进程。该属性参数的默认值为false。该参数不同于"eclipse.application.launchDefault",系统主线程不会等待任何的应用描述符服务启动。eclipse.log.backup.max该参数用于设定允许备份的日志文件的最大数。如果备份的日志文件的数量达到该参数的设定值,则最早的日志文件将被删除。该参数的默认值为10,如果用户设定值小于或等于0,则系统启用默认值。eclipse.log.size.max每个日志文件的最大允许文件大小(单位:KB),该参数的默认值为“1000”。当日志文件达到允许的最大值时,日志文件会循环写入。如果该参数值被设定为0或负值,Equinox系统会使用默认值。eclipse.noExtensionMunging如果该参数值为 "true",则遗留的注册扩展将会保留。默认情况下,这些扩展会更新为Eclipse3.0中的新的扩展点。eclipse.noLazyRegistryCacheLoading
{-noLazyRegistryCacheLoading} 如果该参数值为"true",平台的插件注册表缓存加载优化将不被激活。默认情况下,配置项在需要的时候会从注册表缓存(如果存在)中加载,以提升性能。该参数如果值为true,系统启动时会强制加载所有注册表缓存信息。eclipse.noRegistryCache-noRegistryCache如果该参数值为"true",将不使用内部扩展注册缓存。eclipse.pluginCustomization
{-pluginCustomization}保存默认插件配置的属性文件的文件路径。该属性文件中的配置项会覆盖主配置中的插件属性。如果该参数值为相对路径,则系统会认为路径相对于当前eclipse工作目录。eclipse.product -product运行的产品标识。该参数控制各种产品定义信息和产品使用的applicationeclipse.service.jobs该参数控制
org.eclipse.core.jobs
插件是否注册为OSGi服务,如果值为"false"则不注册为OSGi服务org.eclipse.equinox.preferences
插件是否注册为OSGi服务,如果值为"false"则不注册为OSGi服务eclipse.startTime该参数在Equinox启动时设定。该参数的值为System.currentTimeMillis()方法返回值的字符串表示。用户不需要设定该参数eclipse.stateSaveDelayInterval该参数为系统状态变更请求的序列化延迟间隔,单位毫秒,默认值为30000ms。该参数用于阻止系统管理操作(如安装Bundle组件)过程中产生的大量的磁盘写操作。eclipse.vm -vm该参数指向系统启动所需的Java执行程序(JRE)的路径。如果不指定此项,则 JRE 位于jre
(它与Eclipse.exe 可执行文件位于同一目录)。此信息用于构造系统重启使用的命令行。os.arch
属性的常用值来计算最佳设置。如果在此处指定该项,则这是 Eclipse 平台使用的值。此处指定的值可作为 BootLoader.getOSArch() 用于插件。示例值有:“x86”、“sparc”、“PA-RISC”和“ppc”。osgi.baseConfiguration.area当osgi.configuration.area参数未指定时,该参数用于指定基本的配置信息。以逗号分隔的bundle列表。该列表中的bundle在系统启动运行时,会自动安装并根据设定启动(可选)。每一个Bundle配置形式遵循下面的规范:
[@ [] [":start"]]
如果忽略start-level (>0的整数)被忽略,则将该Bundle设定为默认的启动等级。如果"start"标记被设定,则该Bundle在安装后框架会启动该Bundle。"Simple bundle location"被解释为相对于框架所作路径的上一级目录。"start-level"标明该Bundle应该在哪一OSGi启动等级运行该Bundle,如果。"start-level"未被设定,则系统会自动为Bundle配置适当的默认启动级别。osgi.bundles.defaultStartLevel系统安装的所有的Bundle的启动级别。用户可以在osgi.bundles配置中为某一Bundle指定特定的启动等级。如果未设定Bundle的启动等级,则Bundle的启动等级为该参数设定值。该参数默认值为4。该参数的默认值为"true"osgi.compatibility.
eagerStart.LazyActivationOSGi R4.1规范强制要求所有的Bundle,包括设定了延迟激活策略的Bundle,在允许激活前必须被标记为启动状态。规范添加了一个新方法Bundle.start(options)使得延迟激活的Bundle可以按照设定的延迟激活策略启动。
如果osgi.compatibility.eagerStart.LazyActivation设定为"true",所有设定了延迟激活策略的组件会被自动标记为激活状态;否则,标记了延迟激活策略的组件必须通过Bundle.start(options)方法来启动。
该参数的默认值为"true"。osgi.checkConfiguration如果该参数值为"true",系统会检查配置缓存的时间戳以保证缓存内容反映了安装的Bundle的最新配置。该参数默认值为"false"。osgi.classloader.singleThreadLoads如果该参数值为"true",那么同一时间只能有一个线程允许加载类。默认值为"false"。该参数用于屏蔽可能引发死锁的虚拟机Bug。
OSGi框架使用的上下文类加载器的父类加载器类型,有效的类型包括:
- app - application classloader.
- boot -boot classloader.
- ext - extension classloader.
- fwk - framework classloader.
- ccl - 在框架启动时设定的原始的上下文类加载器(该参数的默认值).
将平台置于开发方式。将可选类路径条目(用逗号分隔的列表)添加至每个插件的运行时类路径。例如,当工作空间包含要开发的插件时,指定
-dev bin
会为每个插件项目的名为 bin
的目录添加类路径条目,允许在其中存储最新生成的类文件。除去了冗余或不存在的类路径条目。osgi.filepermissions.command该参数设定一个可选的操作系统命令用于设定抽取的本机代码的文件操作权限。在一些操作系统中,某些本机代码需要设定为可执行,可以使用此参数设定执行授权的命令。如UNIX类型的操作系统,用户可以使用如下代码设定某一可执行文件具有执行权限:
osgi.filepermissions.command="chmod +rx [fullpath]"
此处[fullpath]用于指代实际的文件路径。该参数用于指定框架扩展的Bundle列表。每一个Bundle遵循如下规则:
系统会在org.eclipse.osgi Bundle的父目录中查找Simple bundle location。框架扩展可以用来使用不同的框架适配来运行Eclipse。框架扩展可用包含一个eclipse.properties文件来设定系统属性。例如,一个提供了自定义框架适配实现的框架扩展可以使用osgi.adaptor属性参数设定其框架适配实现的类名称。OSGi框架类加载器的父类加载器类型,可用的类型包括:
- app - the application classloader.
- boot - the boot classloader.
- ext - the extension classloader.
- current - 加载equinox launcher的类加载器
该属性在同一个Java虚拟机中运行多个OSGi框架实例时,可让每个实例控制自己独立的属性配置。osgi.hook.configurators用逗号分隔的hook配置列表。如果设定了该配置参数,那么系统将只使用该列表中指定的hook配置。所有在hookconfigurators.properties文件中配置的hook将被忽略。
os.name
属性的常用值来计算最佳设置。如果在此处指定该项,则这是 Eclipse 平台使用的值。此处指定的值可作为 BootLoader.getOS() 用于插件,并用于解析插件清单文件中提及的路径中$os$
变量的出现。示例值有:“win32”、“linux”、“hpux”、“solaris”和“aix”。osgi.parentClassloader框架中所有安装的Bundle的类加载器的父类加载器类型。可用的类型为:
- app - 应用程序类加载器.
- boot - 启动类加载器.
- ext - 扩展类加载器.
- fwk - 框架类加载器
用逗号分隔的Bundle签名校验策略。可选的策略包括:
- certificate - 启用证书解析和校验。
- trust - 启用证书信任校验,该策略在"certificate"策略之上。
- runtime - 在运行时校验签名的Bundle组件的内容。该策略在"certificate"策略之上。
- all -等同于"certificate,trust,runtime"。
- true - 等同于"all"。当框架启动时设定。"osgi.support.signature.verify"参数的默认值。
3、其他命令行参数
说明:下述参数仅用于3.3以上版本
- --launcher.ini (Executable) NEW
- --launcher.suppressErrors (Executable) NEW
- -name NEW
- -noSplash (版本1.0+)
- -showSplash (Executable, Main) NEW
- -startup (Executable) NEW
4、launcher.ini文件格式举例
Equinox launcher.ini文件的命令行参数设定格式如下例所示:
-showsplash
org.eclipse.platform
--launcher.XXMaxPermSize
256m
-vmargs
-Xms40m
-Xmx256m
转载自:http://ssydxa219.iteye.com/blog/1308298
- Equinox 和 OSGI 介绍
- Eclipse 、 Equinox 和 OSGi
- tss: Eclipse 、 Equinox 和 OSGi
- Equinox OSGi
- OSGI之Debug Equinox
- equinox的osgi命令
- OSGI Equinox 环境搭建
- osgi equinox helloword
- OSGi#1:Equinox 初探
- OSGI EQUINOX 参数配置
- 使用equinox开发osgi
- Equinox OSGi系列之一 Equinox入门
- Equinox OSGi系列之一 Equinox入门
- Equinox OSGi系列之一 Equinox入门
- Equinox介绍
- Equinox OSGi系列之二 搭建Equinox OSGi核心环境
- Equinox OSGi系列之二 搭建Equinox OSGi核心环境
- 【OSGI】从外部启动Equinox
- jdk调试设置脚本
- Docker文件系统 及 持久化数据
- 关于app的设计和切图( ios & Android )
- 世界上最简单的无锁哈希表
- C# word 下一页 翻页 页数
- Equinox 和 OSGI 介绍
- 蓝桥杯集锦
- 12个有趣的C语言问答
- 【VB.NET程序设计】——总结篇
- Amr and Music
- 黑马程序员-IOS-OC基础-Block
- Amr and Pins
- 剑值offer(面试题目64)数据流中的中位数
- GNU Debug Link