Equinox OSGi

标签：

1.       背景信息

    Equinox项目是Eclipse开源组织提供的OSGi框架的实现。Eclipse自3.0版本开始，其内核移植到OSGi框架上。通过OSGi框架强大的组件控制，交互和管理能力，再加上Eclipse插件的自有特点，Eclipse开源框架得到了跳跃式的发展。同时，OSGi规范得益于Eclipse IDE环境庞大的使用者，OSGi联盟也进入了快速发展时期。
    OSGi框架在2006年之前还不为广大的开发者所知，OSGi的开源框架实现也只有ObjectWeb上的Oscar和Knopflerfish两个实现。最初的OSGi标准主要应用于J2ME和J2SE，Equinox的加入使得OSGi标准的应用领域不断扩充，目前OSGi在J2EE方面的应用也在不断的发展中。IBM Websphere Application Server从6.0版本开始其内核转向由OSGi实现。
    OSGi的本质是将Java面向对象的开发转向面向组件和服务的开发。OSGi框架提供了一套完善的机制用于管理和控制组件（Bundle）、服务（Service）的生命周期，以及组件和服务在其生命周期内的交互。
    本文及后续系列文章将以Equinox项目为基础，讲述如何实现基于OSGi的应用。

2.       Equinox项目概述

Equinox 项目包括 OSGi R4 版本规范核心框架的实现，一系列 OSGi 标准服务 Bundle 及运行基于 OSGi 的系统的一些基础构件。用户可以直接访问该项目在 Eclipse 的网址 Equinox 获取概括性的信息。目前，关于 Equinox 的进展大部分资料及项目进展存在于 Eclipse Wiki 上。

目前， Equinox 项目包括 OSGi 核心框架的实现， OSGi 标准服务 Bundle 实现， OSGi 的服务器端（ J2EE 实现）应用， Equinox 部署更新框架及一些研究方向（未成熟发布的构想如 JMX 管理，安全管理，面向方面的设计与应用等）。

2.1OSGi核心框架的实现

Equinox 的 OSGi 核心实现由三部分组成，包括：

?  OSGi 核心规范的实现（org.eclipse.osgi ）

该项目是 OSGi 核心框架标准规范的实现。由于 Eclipse 在 3.0 版本之前未采用 OSGi 作为系统内核，所以，为了重用 Eclipse3.0 以前核心系统的代码， Equinox 的 OSGi 实现在一定程度上显得比较繁冗。用户如果想研究开源的 OSGi 框架实现的源代码，可以从 Oscar （目前为 Apache 的 Felix 项目）或 Knopflerfish 项目着手。 ObjectWeb 上的 Oscar 项目最初实现 OSGi R2 版本框架时，整个核心的源代码不超过 40 个类文件。现在， Oscar 项目转由 Apache 维护，项目称之为 Felix ，目前已发布 1.0 版本。 Knopflerfish 也是很早实现 OSGi 的一个开源项目，该项目的网站上提供了很多关于 OSGi 编程的注意事项。

?  OSGi 框架启动支持（org.eclipse.equinox.launcher ）

OSGi 框架启动支持对于 Eclipse IDE 开发环境熟悉的开发用户来说并不算陌生。使用 Eclipse 以前版本的用户会发现在 Eclipse 安装目录下有一个 startup.jar 的文件，该文件是 Eclipse 开发环境的入口程序封装。 Equinox 将该 Jar 文件的实现迁移为一个独立的 OSGi Fragment 。该 Fragment 主要是帮助 Equinox 建立起运行环境，如类加载路径，运行配置参数等等。

?  Equinox 启动可执行程序

Equinox 启动可执行程序即为 eclipse.exe 文件，该执行程序并不是 Eclipse 以前版本的 exe 可执行文件，而是由原来的 eclipse.exe 程序拆分而来，该执行文件的一部分功能拆分为一个共享 DLL ，放置在 OSGi 框架启动支持段项目（ org.eclipse.equinox.launcher ）中，与原来的 Eclipse 根目录下的 startup.jar 文件功能合并。

2.2OSGi标准服务Bundle实现

OSGi 在提出核心框架规范的同时为一些常用的服务如日志服务（ LogService ），配置管理服务（ Config Admin ），事件管理服务（ Event Admin ）， HTTP 服务（ HTTP Service ）等。 Equinox 提供了大部分 OSGi 标准服务的 bundle 的实现，同时，借助于 Eclipse 环境的一些自身的特点， Equinox 在实现这些 OSGi 标准服务的同时，提供了很多功能扩展服务（如 org.eclipse.equinox.common ）。

Equinox 项目目前提供的 OSGi 标准服务实现如下所示：

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。

[@ [] [":start"]]

osgi.filepermissions.command="chmod +rx [fullpath]"

3、其他命令行参数

说明：下述参数仅用于3.3以上版本

• --launcher.ini (Executable) NEW

Equinox OSGi

标签：

原文地址：http://my.oschina.net/yygh/blog/499657